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CHAPTER 1 
TRANZ PRODUCT DEFINITION 


1-1. INTRODUCTION 


The AMC translator utility TRANZ is a programming tool designed to aid 
in upgrading standard 8080/8085/Z80 assembler language source code to 
the AmZ8000 instruction set and format. TRANZ executes in an AmSYS 8/8 
environment in 64K bytes of memory, translating source statements into 
functionally identical AmZ8000 statements. Registers specified in 
source-code operands are automatically mapped to the functionally 
equivalent AmZ8000 registers. 


Where functional equivalencies do not exist, the non-translatable 
source statements are passed unchanged through the translator and are 
flagged for user action. (Note that TRANZ does not include a facility 
for interrupt translation.) In some cases (e.g., where exact memory- 
ordering or flag-bit setting is required), one line of source code can 
result in multiple lines of object code from the translator. 


The output of TRANZ is compatible with the AmZ8000 assembler MACRO8000 
and can be used as the source-code input to that utility- (Refer to 
the MACRO8000 Assembler User’s Manual for usage details.) 


The translation process is user-controlled through a series of commands 
to specify: translation qualities for byte ordering and flag-bit 
setting, ordering and testing; input format; output (object file) 
content; screen display content; and the selective translation, 
deletion, replacement, or copying of source code. 


Translator actions may be repeated until the end of the source file, 
for a specified number of source lines, until a key word is reached, or 
until a translation problem of a specified severity occurs. 


Translator commands can be embedded in the source code for execution in 
a batch mode, or can be specified interactively by the user after in- 
voking TRANZ. Translation parameters are entered in response to screen 
prompts to specify translator actions (translate, delete, replace, copy 
list options, execute stored command, or quit) and translation mode 
settings (varying the exactness of the translation, display and output 
selection, input column selection, or set the stored command). Diag- 
nostic messages flag user-command errors, source errors, and notes, 
warnings and errors in translation. 


1-2. TRANSLATOR MODES 


TRANZ can be commanded to execute either interactively or in batch 
mode. 
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1-3. INTERACTIVE MODE 


In Interactive mode, translator commands and parameters are specified 
through user-entered responses to screen prompts for a command. Com- 
mands are not executed until the entire command-parameter set is cor- 
rectly entered and terminated with a command delimiter (NEW LINE key- 
stroke, blank, or non-alphanumeric characters). Note that in Inter- 
active mode, commands also can be embedded in the source code. 


1-4. BATCH MODE 


In batch mode, translation commands (if any) are placed in the source 
code (in line) prior to invoking TRANZ. The in-line commands are then 
executed as they are encountered in the code. Batch mode setting is 
essentially the equivalent of interactive mode with TRANSLATE UNTIL END 
OF FILE action specified. : 


1-5. IN-LINE COMMAND SPECIFICATION 
Any allowable command may be placed in the source code by preceding the 
command with an exclamation point in column l. As an example, the 
source-code line entry 
IMTO, 
commands that only the translated object lines are to be displayed at 
the user’s terminal beginning at the point at which the embedded com- 
mand is encountered. The command is evaluated as 

M identifies the in-line entry as change to mode-setting commands 


T specifies terminal display selection 


O specifies that all translated source-program lines are to be 
displayed as they occur 


- terminates the command string. 
In-line commands must be entered as shown above; blanks may not be used 
to separate the members of a command set, or between the exclamation 


point, the command set and the terminating comma. (Blanks are 
intrepreted by TRANZ as terminators) 


1-6. TRANSLATION QUALITIES 


The user has the option of specifying the precision of the translation; 
that is, the exact simulation of flag settings, flag-bit ordering and 
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testing, and byte ordering. By using the "Translate Until..." 
option, translation qualities may be altered during the course of the 
translate operation. With most memory-transfer and arithmetic 
instructions however, the translated differences in flags and 
memory-ordering do not effect execution of a program. For this reason, 
and because an exact simulation requires generation of multiple 
instructions (on the order of 5) for each source instruction, it is 
recommended that all translation qualities be set to Don’t Care 
condition when possible. In particular, setting the flag-bit ordering 
quality (F) to Care mode in PUSH PSW and POP PSW instructions requires 
the addition of two subroutines to the output code. (The subroutines 
are contained in Appendix B.) 


1-7. REVERSE BYTE ORDERING, MEMORY (B) 


The B quality set to Care condition specifies adjustment for the 
ordering of bytes as they appear in memory. The order in which bytes 
are stored in memory varies between the source CPUs and the AmZ8000. 
Further, the Z80 assembler reverses the order in which the high and low 
bytes of 16-bit word declaration values are stored, while the 8080 and 
8085 reverse the bytes in both word-declaration values and strings. 
The effect of the source CPU byte ordering and of setting the TRANZ 
translation B qualilty to Care and Don’t Care conditions are shown in 
table 1-1. The right-hand columns list the order in which DW ‘string’, 
DW VALUE, and DB “string” are (1) stored in memory, (2) referenced by 
word, and (3) referenced by byte. Within each of the three categories, 
the byte order is defined for each source CPU, and for the translated 
AmZ8000 code with the B quality setting as both Care and Don’t Care. 


Adjustment is accomplished by a combination of reversing the byte order 
of some declarations (i-e., DW) and by combining word size load and 
store operations with byte exchanges. If data defined in a DW 
instruction is referenced by bytes, or if data defined in a DB 
instruction is referenced by words, the B quality Care condition is 
required. 


However, setting this quality to Care can cause a_e significant 
degradation of 16-bit address and data processing. The B quality 
default setting is to Don’t Care condition. 


1-8. REVERSE BYTE ORDERING, STACK (K) 


The K translation quality specifies adjustment for the reverse byte 
ordering of words as they appear on the stack. This is necessary since 
the user could reference the stack as if it were normal memory. 
Setting the K translation quality will significantly impact stack 
references, including subroutine linkage. The K quality default 
setting is to Don’t Care condition. 
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TABLE 1-1. BYTE ORDERING FOR STORAGE, REFERENCE 


Source CPU Directives 
DW  'STRING' DW Value DB 'STRING' 
pu80/88 p080/88 B080/85 


(1) 


Storage: 


Source CPU 
AmZ8000 
Don't Care 
Care 


Word Reference: 


Source CPU 
AmZ8000 
B = Don't Care 
B = Care 


(3) 
Byte Reference: 


Source CPU 
AmZ8000 
B = Don't Care 
B = Care 


High-low byte storage 

Low-high byte storage 

Compatible byte order reference 

Compatible reference, byte reversed 
Incompatible (byte-reversed) value reference 


1-9. FLAG CONTROL WORD FLAG-BIT ORDERING (F) 


Setting the F translation quality to Care condition requires that the 
flag bits in the Flag Control word (FCW) be ordered such that source- 
code references to the flag word are exactly simulated in the output 
code. The Care/Don’t Care status of the F quality must be identical 
for the PUSH/POP and CALL/RETurn instructions. The FCW formats for the 
Intel 8080/85, Z80, Am8080 and AmZ8000 CPUs are shown in figure 1-1. 
The F quality default is to Don’t Care mode. 
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1-10. DEFAULT FCW FLAG-BIT TRANSLATION QUALITIES 


The Parity (P,P/V), Auxiliary Carry (AC,H) and Decimal Adjust (DA,N) 
qualities default to Don’t Care condition; the Carry (C), Zero (Z), and 
Sign (S) qualities all default to Care condition. As previously noted, 
it is recommended that the translation qualities be set to Care condi- 
tion only when required. In particular, P or P/V should remain in 
Don’t Care condition wherever possible, since setting this quality to 
Care will increase the amount of code generated for many 8080/8085 in- 
structions. 


The D quality set to Care condition specifies adjustment for the 
effects of using an 8080/8085 DAA instruction in a subtract operation. 
(This instruction sets the DA (N) flag for decimal adjust after incre- 
ment and add operations, but not after subtract or decrement opera- 
tions.) It is recommended that the user include the necessary decimal- 
adjust code in the source rather than setting the D quality to Care 
condition since it can seriously degrade BCD arithmetic. The D quality 
default setting is to Don’t Care condition. 


8080/85, Am8080 FCW 
15 7 0 
| A | ES ae Len Rs Re ee ee 


AmZ8000 FCW 
15 


| S [P/V|DA 


780 FCW 
15 7 0 
| A Ee ee EN Ec 


Sign flag 

Zero flag 

Auxiliary (Half) Carry (Same as H) 
Parity flag (Same as P/V) 

Carry flag 

Parity/Overflow flag 

Decimal Adjust flag 

Half Carry flag 

Add/Subtract flag 


Figure 1-1. FCW Formats 
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1-11. TRANSLATION QUALITY SELECTION SUMMARY 


Table 1-2 summarizes the translation quality options and the default 
settings for each quality- 


TABLE 1-2. TRANSLATION QUALITY OPTIONS 


Quality Default 
Sett ing* 


Auxiliary (Half) Carry flag bit 
Carry flag bit 

Parity (Parity/Overflow) flag bit 
Sign flag bit 

Zero flag bit 

Decimal adjust 

Byte ordering, memory 

Byte ordering, stack 

FCW Flag-bit ordering 


A 
C 
i 
3 
Z 
D 
B 
K 
F 


SO) OS a Ss 9 


+ 
a] 


Care 
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1-12. INSTRUCTION TRANSLATION 


This subsection defines the TRANZ capabilities for translating in- 
struction operands. The specific translations performed for each 
instruction and the AmZ8000 equivalents of the 8080/8085 and Z80 as- 
sembly language pseudo-operators are defined in the appendices to this 
manual. 


1-13. ADDRESS TRANSLATION 


TRANZ corrects the constant values in address relative operands (e.g. 
JMP $+4, JNZ label+4) for the increased size of the AmZ8000 code pro- 
duced; however, absolute address operands and RST and PCHL instructions 
are flagged to the user with a warning. Additionally, operands and 
pseudo-operands (such as the Intel % operator) are ignored and flagged 
to the user when there is no equivalent translation. 


1-14. REGISTER-REFERENCE TRANSLATION 


Source code register-reference operands are translated to the compar- 
able AmZ8000 registers, as defined in table 1-3. 
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TABLE 1-3. REGISTER MAPPING 


Source Registers AmZ8000 Register 


SP R15 
8080/8085 F A RHO RLO 
and Z80 B C RH1 RLI1 
Register D E RH2 RL2 
Set H L RH3 RL3 
7.80 | FA’ R8 
Alternate BC’ R9 
Register DE’ R10 
Set HL’ R11 


Z80 Index IX 
Registers LY 


Translator Working byte register 
Registers Working word register 


1-15. IDENTIFIER TRANSLATION 


Identifiers are not modified by TRANZ except that ignorable characters 
are removed. The conversion of source code identifiers to valid TRANZ 
identifiers must be performed by the user prior to translation, as 
follows: 


e The user must translate the special characters ? , # and $ to 
legal characters. These include A...Z (except for Z80 assembler 
code, equivalent to aeeez), 0-.--9, and @. 


e For Z80 source code, the user must ensure that all lower case 
variables used are equivalent to upper case variables, since in 
Z80 assembly language A...Z is not the same as a..z. 


e Ambiguous label and EQU identifiers are found by the object 
(AmZ8000) assembler; ambiguous SET identifiers are not found and 
may result in incorrect assembly. 


e Reserved words (i-e-, AmZ8000 opcodes or pseudo-opcodes) used as 
identifiers in the source code are flagged to the user as 


warnings. 


e All identifiers not declared prior to reference are treated by 
TRANZ as labels. 
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CHAPTER 2 
USING TRANZ 


2-1. INTRODUCTION 


Execution parameters for TRANZ are specified through user responses to 
screen prompts. Translator command prompts are presented in two clas- 
ses: actions and mode settings. Mode settings define the required ex- 
actness of the translation; action commands specify operations such as 
copy, delete, insert source statements, etc. 


Uniess noted in the descriptions, each command iine must be terminated 
with a delimiter (NEW LINE, blank, or a non-alphanumeric character) 
before the command can be accepted by TRANZ.~ Parameters can be = com- 
manded in a single input line with the system call or they may be en- 
tered singly in response to each prompt. 


When invoked, TRANZ fetches the translation-table file for the user- 
specified assembly language: filename TRANZ of type .I, -5, or .Z- A 
temporary file, TRANZ.$S$, is created as a work file for the  trans- 
lation process. The temporary work file, which is approximately twice 
the size of the output file to accommodate intermediate translate oper- 
ations, is deleted after the translation is completed. The output of 
TRANZ is an ASCII file of default type .ZSC, the default input filetype 
to MACRO8000. If an output filename is not specified, the source file- 
name is used. The user also can specify a zero output, in which case 
an output file is not generated. 


2-2. CONVENTIONS USED 


Within this chapter, the following conventions are used in defining 
commands and system prompts/responses: 


Underlines indicate data to be supplied by the user. 


[ ] Square brackets indicate that the enclosed parameter or 
partial parameter is optional. 


lowercase Lowercase letters indicate variables for which values 
are to be supplied by the user or by TRANZ as output. 


UPPERCASE Uppercase letters indicate prompts displayed by TRANZ to 
request a user command, or responses to a user-entered 
command. Entries must be input exactly as shown. 


2-3. INVOKING TRANZ 


TRANZ can be run in either of two modes: Interactive or Batch. In 
Interactive mode, commands and execution parameters are specified 
through responses to TRANZ prompts, although commands and parameters 
also may be embedded in the source code. (Refer to chapter 1 for a de- 
scription of the in-line command format.) In Batch mode, all commands 
and parameters must be in-line in the source code. The translator is 
invoked by entering 


XPAS TRANZ 
TRANZ responds with 


8080, 8085 AND Z80 to Z8000 TRANSLATOR 
TRANZ n-n mm/dd/yy 


where nen is the version level and mm/dd/yy is the version date. This 
is followed by the prompts 


ENTER SOURCE (DEFAULT TYPE IS .ASM): sfile[.typ] 
ENTER DESTINATION (DEFAULT sfile.ZSC): [dfile[.typ]] 
where 


sfile[.typ] is the disk file containing the source assembly 
language. 


[dfile[.-typ]] is the user-assigned disk file into which the 
translated code is to be placed. If omitted, the destination 
filename defaults to that of the source file, of default type 
-ZSC, the MACRO8000 default input file type- (Note that if the 
destination file is assigned as (, no output file is produced.) 


The next message 
ENTER SOURCE ASSEMBLY LANGUAGE (1,5,Z): __ 


prompts for the one of the following codes to specify the source as- 
sembly language: 


I = Intel 8080 
5 Intel 8085 
Z = Z80 


Finally, the message 


ENTER OPERATION (I1,B): 


prompts for the operating mode, either Interactive or Batch. Selection 
of Batch operating mode is the equivalent of an action command to 


translate until the end of the file. Code translation begins after the 
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B command delimiter is encountered. Selection of Interactive operating 
mode causes TRANZ to prompt with the action command line 


ACTION (T,C,R,D,X,M,L,Q):_ 
requesting user entry of the first translator action command. 


Since the prompts to invoke TRANZ are order-dependent, the call also 
can be given in a single line of the form 


XPAS TRANZ sfile[.typ] ,[dfile[-typ]] ,language,operation 
As an example, the call 
XPAS TRANZ SFILE,,Z,B. 


specifies source filename SFILE of default type -.ASM, destination file- 
name (default) SFILE.ZSC, source assembly language 2Z80, # 42batch 
operation. In this command-line format, a comma must be inserted to 
indicate that the destination parameter has been omitted. Note the use 
of a period as the call delimiter. 


After the source assembly language is specified, TRANZ loads the 
appropriate translation table and translates the source file to AmZ8000 
assembly language statements. 


2-4. INTERACTIVE TRANSLATION COMMANDS 


NOTE 


If a command response is incorrectly en- 
tered, Control-X or Control-U can be 
used to cancel the current command line. 
The command prompt will be immediately 
redisplayed and TRANZ will halt and wait 
for the response entry. 


When translating interactively, the user selects translation conditions 
through responses to prompts issued by TRANZ in two major classes: 
Action and Mode~-Setting. The prompt line for each class includes codes 
assigned to each translation parameter command in that class. The user 
enters the desired code on the prompt line, and TRANZ verifies the 
selection by completing the code word and adding any subcodes’ within 
the command. A selected subcode is verified in the same manner. As an 
example, given the Action command line 


ACTION (T,C,R,D,X,M,L,Q): 


a user selection of code T would result in the line 

ACTION (T,C,R,D,X,M,L,Q): TRANSLATE UNTIL (E,S,WD,#): 

selecting subcode E results in line completion as 

ACTION (T,C,R,D,X,M,L,Q): TRANSLATE UNTIL (E,S,WD,#): END OF FILE 


As a result of this sequence, the entire file will be translated, with 
all specified mode settings. 


By entering a command delimiter (blank, NEW LINE, or non-alphanumeric 
keystroke) when the ACTION or MODE SETTING line is displayed, the user 
can command a display that lists all options in that class. (The 
ACTION/MODE SETTING command line remains active on the screen during 
the display.) The Action and Mode Setting class options are shown in 
figures 2-1 and 2-2. Note that each command class includes an option 
that allows the user to switch between classes. 


ACTION CLASS COMMANDS 
TRANSLATE SOURCE 

COPY SOURCE 

REPLACE SOURCE 

DELETE SOURCE 


EXECUTE STORE 

(stored command 40 bytes) 
MODE SETTING CLASS COMMANDS 
LIST TRANSLATION QUALITIES 
QUIT 


Figure 2-1. Action Class Options 


MODE SETTING CLASS COMMANDS 
LIST TRANSLATION QUALITIES 
CARE 

DON'T CARE 

TERMINAL DISPLAY SELECTION 


OBJECT SELECTION 

INPUT COLUMN SELECTION 
STORE COMMAND 

(stored comand 40 bytes) 
ACTION CLASS COMMANDS 


AROoOo7UDNr = 


> 


Figure 2-2. Mode-Setting Class Options 


2-5. ACTION COMMANDS 


Action commands direct the translation, deletion, replacement and 
insertion of source code into the selected terminal and object file 
output. After the selection of Interactive operation, TRANZ displays 
the Action command line prompt 


ACTION (T,C,R,D,X,M,L,Q): _ 


and waits for a response. After each action command is entered and 


processed as defined by the mode-setting parameters, and all in-line 


commands encountered have been processed, the ACTION prompt is redis- 
played and TRANZ waits for further user input. 


After execution of the conditional action commands T (Translate until 
x), C (Copy until x), R (Replace until x) and D (Delete until x), the 
current status is displayed as shown in figure 2-3, and TRANZ prompts 
for entry of another action command. In the status display, e is the 
error severity code letter and nnn represents line numbers and the 
current program counter location. 


ERROR SEVERITY 
SOURCE PC 


OBJECT “PC 
CURRENT SOURCE LINE 
(Current source line 80 bytes) 


Figure 2-3. Current Status Display 


NOTE 
All ACTION commands must be terminated 
with a delimiter (NEW LINE, blank, or 
non-alphanumeric character) before 
they will be accepted by TRANZ for 
processing. 


2-6. ACTION: Translate Until 


Translate Until specifies the condition under which translation of the 
source assembler language statements is to terminate. 


ACTION (T,C,R,D,X,M,L,H): TRANSLATE UNTIL (E,S,°WD’,#): 
A command delimiter results in translation of one line of input file 


source code, and processing of the specified output; i-.e., terminal 
and object output as defined in the mode setting. 


-+eTRANSLATE UNTIL (E,S,°WD’,#): END OF FILE 


An E response results in translation of the entire file, using selected 
mode-setting options. 


»+eTRANSLATE UNTIL (E,S,°WD’,#): SEVERITY (N,W,Z) 


An S response results in translation of the file until a problem of the 
selected severity is encountered, where 


N = translate until a source line is encountered that cannot be fully 
translated (possibly due to translation quality selections), or 
until translator address recalculation must be done. Note that 
entering a command delimiter at this point has the same effect as 
an N response. 


W = translate until a source line is encountered for which a fix 
routine is not available. 


Z = translate until a source line is encountered that cannot be 
translated, or until a command error is encountered. 


-+-TRANSLATE UNTIL (E,S,°WD’,#): ‘string’ 


Selection of “WD’ (keyword) is in the form of a string of up to sixteen 
characters, bounded with single quotes. (Note that the code ’WD’ need 
not be entered.) When the specified string is encountered in the 
source line, TRANZ halts and prompts with the ACTION display for user 
intervention. 


..-TRANSLATE UNTIL (E,S,’WD’,#): n 
Selection of # is in the form of an integer value n. (Note that the 


code # need not be entered.) TRANZ processes n source lines, halts and 
prompts with the ACTION display for user intervention. 


2-7. ACTION: Copy Until 


Copy Until allows specification of the condition under which the copy 
of source lines into untranslated object-file lines is to stop. 


ACTION (T,C,R,D,X,M,L,H): COPY UNTIL (E,’WD’,#): _ 


Entering a command delimiter results in the output (copy) of one line 
of untranslated source code as defined by the mode-setting options for 
the selected output. 
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be ‘ 


---COPY UNTIL (E,°WD,°#): END OF FILE 


An E response results in a copy of the entire file as defined by the 
mode-setting options. 


---COPY UNTIL (E,°WD’,#): “string” 


Selection of “WD’ (keyword) is in the form of a string of up to 16 
characters, bounded with single quotes. (Note that the code ’WD’ is 
not required.) When the specified string is encountered in a source 
line, the copy operation halts and TRANZ prompts with the ACTION 
display for user intervention. 


..-COPY UNTIL (E,’WD’,#): n 
Selection of # is in the form of an integer value n.- (Note that the 


code # is not required.) TRANZ copies the next n source lines, halts 
and prompts with the ACTION display for user intervention. 


2-8. ACTION: Replace Until 
Replace Until specifies the termination point for replacement of source 
code with user-entered code. 

ACTION (T,C,R,D,X,M,L,H): REPLACE UNTIL (E,’°WD’,#): _ 
Entering a command delimiter causes TRANZ to prompt with 

REPLACE WITH (TERMINATED BY //): 
and wait for replacement code, terminated with a double slash, to be 
entered at the terminal. The code is then processed as defined by the 
selected mode-setting parameters. The command delimiter specifies a 
single replacement line, by default. 

-+eREPLACE UNTIL (E,°WD’,#): END OF FILE 
An E response results in replacement of the remaining source file with 
(untranslated) code entered at the console. The code is then processed 
as defined by the mode-setting parameters. 

--+REPLACE UNTIL (E,°WD’,#): “string” 
Selection of ‘WD’ (keyword) is in the form of a string of up to 16 


characters, bounded with single quotes. (Note that the code “WD’ is 
not required.) When the specified string is encountered in a source 


line, the replace operation halts and TRANZ prompts with the ACTION 
display for user intervention. 


..-REPLACE UNTIL (E,’WD’,#): n 


Selection of # is in the form of an integer n- (Note that the code # is 
not required.) TRANZ replaces the next n lines of source code with the 
user-entered code, and processes the code as defined by the mode- 
setting parameters for the terminal and object output. 


2-9. ACTION: Delete Until 


The Delete option does not delete the specified source-code lines; 
rather, TRANZ ignores these lines during the translation operation. 
Thus, Deleted lines remain in the source code but are not copied as 
part of the object code. 


Delete Until specifies the point at which the deletion of source | 
assembly language code is to terminate, with no untranslated assembly 
language object code produced. 


ACTION (T,C,D,R,X,M,L,H): DELETE UNTIL (E,’WD’,#):_ 


Entering a command delimiter causes TRANZ to delete (skip) the current 
source line. 


---DELETE UNTIL (E,’°WD’,#): END OF FILE 


An E response results in deleting (skipping) the file from the current 
source line through the end of the file. 


-+-DELETE UNTIL (E,°WD’,#): ‘string’ 


Selection of ‘WD’ (keyword) is the form of a string of up to 16 
characters, bounded with single quotes. (Note that the code ‘WD’ is 
not required as part of the entry.) When the specified string is 
encountered at the beginning of a source line, the delete (skip) 
operation halts and TRANZ prompts with the ACTION display for user 
intervention. 


.. DELETE UNTIL (E,’WD’,#): n 


Selection of # is in the form of an integer n- (Note that the code # 
is not required.) TRANZ will skip the next n lines of source code. 


2-10. ACTION: nX (Execute) 


The user can create a stored command, consisting of up to 40 bytes of 
action, class-switching, and mode-setting commands, by specifying the S 
mode-setting option. (Refer to paragraph 2-21 for a description of the 
String mode-setting command.) The action command nX causes the stored 
command to execute n times. When n is not specified, the default value 
is 1. Note that both the S and X commands can be nested. 


2-11. ACTION: Mode-Setting 


Entering an M response causes TRANZ to switch to mode-setting class 
and prompt for a command. (This command is executed when it is’ re- 
ceived; a delimiter may not be used to terminate the MODE command.) 
ACTION (T,C,R,D,X,M,L,H): MODE SETTING 
MODE (i5650;7T,0;155;A): 


TRANZ continues to prompt for mode-setting class commands until an A 
(Action) command is issued. 


2-12. ACTION: List 


Entering an L response causes TRANZ to display the current translation- 
quality settings and register mapping, as shown in figures 2-4 and 2-5. 


SOURCE MACHINE ASSEMBLY LANGUAGE 
CARRY FLAG 

ZERO FLAG 

SIGN FLAG 

PARITY FLAG 

AUXILIARY CARRY FLAG 

FLAG BIT ORDER 

DECIMAL ADJUST SUBTRACT 

BYTE ORDER IN MEMORY 

BYTE ORDER ON STACK 


NWOoONYrUIUIMAND 


m 
q 
q 
q 
q 
q 
q 
q 
q 
q 


Figure 2-4. Translation Quality Status 
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Working Byte Register 


Working Word Register 


Figure 2-5A. 8080/8085 Register Mapping 


Object 
R15 


L 


Working Byte Register 


Working Word Register 


Figure 2-5B. Z80 Register Mapping 


In figure 2-4, m identifies the source CPU (8080, 8085 or Z80), a iden- 
tifies the source assembly language (I,5 or Z), and q identifies the 
current Care/Don’t Care status of the translation qualities. 


The mapping format shown in figure 2-5A is displayed when the source 
CPU is either an 8080 or 8085. When the source CPU is a Z80, the for- 
mat shown in figure 2-5B is displayed to identify the Z80 alternate 
register set mapping and index registers. 


2-13. ACTION: Quit 


Entering a Q response causes TRANZ to halt execution, without gener- 
ating any output. Output generated prior to the issuance of the Q 
command can be saved by issuing a Delete until End of file command. 


2-14. MODE-SET TING COMMANDS 


Mode-setting commands enable the user to specify the exactness of the 
translation through setting Care/Don’t Care qualities, and allows’ spe- 
cification of the terminal display type as well as the selection of 
output types to be included in the object file. In Interactive oper- 
ating mode, the ACTION command prompt is displayed following the util- 
ity call sequence. An M response causes TRANZ to enter mode-setting 
class control, display the prompt 


MODE (L,C,D,T,0,1,S,A): __ 


and wait for a response. By entering a delimiter (NEW LINE, blank, or 
non-alphanumeric character), the user can command a display of mode- 
setting class options, shown in figure 2-2. 


TRANZ continues to prompt for MODE-setting commands until the user spe- 
cifies a switch to ACTION class commands (MODE command A). 


NOTE 


All MODE-SETTING commands must be termi- 
nated with a delimiter (NEW LINE, blank, 
or non-alphanumeric character) before 
they will be accepted by TRANZ for 
processing. 


2-15. MODE: List 


Entering an L response causes TRANZ to complete the command line as 


MODE (L,C,D,T,0,1,S,A): LIST 


and to display the current translation-quality settings and register 
mapping, as shown in figures 2-4 and 2-5. In figure 2-4, m identifies 
the source CPU (8080, 8085, or Z80), a identifies the source assembly 
language (1,5 or Z), and q identifies the current Care/Don’t Care 
status of the translation qualities. 


The mapping format shown in figure 2-5A is displayed when the source 
CPU is either an 8080 or 8085. When the source CPU is a Z80, the for- 
mat shown in figure 2-5B is displayed to identify the Z80 alternate 
register set mapping and index registers. 


(The LIST command is executed when it is received; a delimiter may not 
be used to terminate the command.) 


2-16. MODE: Care 


A Care response specifies that selected translation qualities are to be 
set to care condition. 


MODE (L,C,D,T,0,1,S,A): CARE QUALITIES (C,Z,S,P,A,F,D,B,K): _ 


The user can set any or all translation qualities (see figure 2-4) to 
Care condition to specify that the translated code exactly simulate the 
function of the source code. Note that the C (Carry), Z (Zero) and § 
(Sign) flags default to Care conditions; all others default to Don’t 
Care condition. (Refer to chapter 1 for a detailed discussion of the 
translation quality Care/Don’t Care settings and the effects of each 
on the object code generated.) 


2-17. MODE: Don’t Care 


A Don’t Care response specifies that selected translation qualities are 
to be set (or reset) to don’t care condition. 


MODE (L,C,D,T,0,1,5,A) DONT CARE QUALITIES (C,Z,S,P,A,F,D,B,K): _ 


The user can set default Care qualities C,Z,S to Don’t Care or can at 
any time reset any Care qualities (see figure 2-4) that are no longer 
required, thus generating smaller, faster-execution object code. 
(Refer to chapter 1 for a detailed discussion of the Care/Don’t Care 
Settings and the effects of each on the object code generated.) 


2-18. MODE: Terminal Output Select 


A Terminal Output Select response allows the user to specify the types 
of output to be displayed at the terminal. 


MODE (L,C,D,T,0,1,S,A): TERMINAL OUTPUT SELECTION (S,0,Z,W,N,C): _ 


Entering a command delimiter causes the selected output types to be 
displayed at the terminal as they occur. 


Source specifies that all source program operations and _ pseudo- 
operations, and all source code comments are to be displayed. 


Object specifies that all object lines (translated source code) are to 
be displayed. 


Z(error) specifies that all translation errors are to be displayed. 
Notes specifies that all translation notes are to be displayed. 
Warnings specifies that all translation warnings are to be displayed. 
Commands specifies that all translator commands are to be displayed. 
The default displays are Notes, Warnings and Commands in Interactive 
mode, and Warnings in Batch mode (Error messages are always displayed.) 
To restore the default display-option settings, enter the Terminal 
display response to the MODE command and enter a command delimiter with 


no display options. This null-list entry restores the default 
settings. 


2-19. MODE: Object Output Select 
The Object Output Select allows the user to specify the types of output 
to be contained in the object file. 

MODE (L,C,D,T,0,1,S,A): OBJECT OUTPUT SELECTION (S,0,Z,W,N,C): | 
Entering a command delimiter causes the selected types to be output to 
the object file as they occur. 

Source specifies that all source program operations and pseudo- 
operations, and all source code comments are to be output to the object 


file. 


Object specifies that all object lines (translated source code) are to 
be output to the object file. 


Z(error) specifies that all translation errors are to be output to the 
object file. 
Notes specifies that all translation notes are to be output to the 


object file. 


Warnings specifies that all translation warnings are to be output to 
the object file. 


Commands specifies that all translator commands are to be output to the 
object file. 


The default is to output object only. To restore the object output 
default options, enter the Object select response to the MODE command 
and enter a command delimiter with no other options. This null-list 
entry restores the default settings. 


2-20. MODE: Input Column Select 


The I mode-setting command allows the user to define the source-line 
format to be translated, by specifying character-column positions. In 
this way, extraneous characters such as source line numbers, program 
counter values and binary object listings are ignored in _ the 
translation process. | 


MODE (L,C,D,T,0,1,S,A): INPUT COLUMNS (FROM,TO): _ 


The selected columns are entered as two decimal values (vl<v2) 
separated with a comma and terminated with any delimiter. TRANZ 
acknowledges the selection with the display 


TRANSLATE FROM nn TO nn 


To reset the source-line translation limits to translate columns 1 to 
80 (the default setting), enter the I response to the MODE command, 
followed by any delimiter. 


2-21. MODE: Store Command String 


Store Command String allows the user to specify a command string of up 
to 40 bytes in length. 


MODE (L,C,D,T,0,1,S,A): STORE COMMAND (STRING): _ 


TRANZ halts and waits for the command string to be entered. The stored 
command can comprise any number of commands, up to the 40-byte limit, 
and commands can be nested within the boundary parentheses. As an 
example, a stored command string of the form 


(T’OPFLD’,R1; MACNAME RL; //X) 


would direct TRANZ to translate until the string OPFLD is encountered, 
replace that one line with the line MACNAME RL, and re-execute_ the 
stored command. This would effectively translate all lines with the 
specified opcode field to a macro call. 


Note that each command is terminated with a delimiter (in the above 
example both a comma and a semicolon were used). The entire stored 
command, including the terminating double slash, must be enclosed in 


— 


parentheses. Command sets nested within a stored command also must 
include the terminating double slash and surrounding parentheses. 
Stored commands are executed using the Action command X (refer to 
paragraph 2-10 for a description of the eXecute command). 


2-22. MODE: Action 


An A response causes TRANZ to switch to Action class and prompt for a 
command. 


MODE (L,C,D,T,0,1,S,A): ACTION COMMAND 


ACTION (T,C,R,D,X,M,L,H): ___ 


(This command is executed when it is received; a delimiter may not be 
used to terminate the ACTION command.) TRANZ remains under Action class 
control until another M (Mode) command is issued. 


2-23. PROGRAM TERMINATION 


TRANZ makes two passes through the source code. The actual translation 
is performed during pass one; address relative corrections are made 
during pass two. (TRANZ automatically enters pass two upon reaching 
the end of the source file-) At the end of pass two TRANZ terminates, 
all files are closed, the temporary file TRANZ.S$S$ is deleted, and 
control returns to the operating system. 


The Quit command also can be used to abort TRANZ at any point in the 
translation cycle. After normal (end-of-source-file) termination, the 
message shown in figure 2-6 is displayed, where nn are decimal values 
representing the number of bytes of machine code in the source file and 
translated object file, the number of lines of source code and the 
number of notes, warnings and errors generated during the translation 
process. 


TRANZ COMPLETE: SOURCE nn BYTES nn LINES 
OBJECT nn BYTES 


ERRORS: nn 
WARNINGS: nn 
NOTES: nn 


Figure 2-6. TRANZ Termination Message 


TRANZ can terminate abnormally if, in Batch mode, all embedded commands 
are completed before the end of the source code is reached. In this 
case the message 


*XXBATCH COMMAND REQUIRED BUT NOT FOUND - FATAL ERROR 


will be displayed and TRANZ will abort without producing an object 
file. 


If TRANZ aborts abnormally, or if the user exits before translator 
operations are completed, the temporary file TRANZ.SSS (used to hold 
intermediate results of the translation) is not automatically deleted. 
Then, if the user attempts to restart the utility, TRANZ will not be 
able to open a temporary file as it still exists on the diskette. In 
this case, the fatal error message '"-3'' is issued. The user must 
delete the existing TRANZ.SSS and restart the utility. 


2-24. DIAGNOSTIC MESSAGES 


Three types of diagnostic messages--notes, warnings, and errors--can be 
generated. By specifying Mode-Setting options, the user can select the 
types of messages to be included or excluded from the terminal or ob- 
ject file output. Notes are identified with a single asterisk (*), 
warnings with two asterisks, and errors with three asterisks. Follow- 
ing display of an error message, the offending line is displayed with 
an exclamation point (!), the source and object program counter loca- 
tions are displayed, and the current source line is identified. 


NOTES: 


%* MAXIMUM FIXUP NOT PERFORMED 
% ADDRESS EXPRESSION CORRECTED 
* ADDRESS-RELATIVE FIXUP SUSPENDED ACROSS THIS INSTRUCTION 


WARNINGS: 


KK WORD BOUNDARY ERROR -— BYTE INSERTED 

zx EXPRESSION NOT EVALUATED 

KK ILLEGAL SYMBOL 

zx ABSOLUTE REFERENCE MADE (PCHL, RST, OR NUMERIC ADDRESS) 
Kx EXACT TRANSLATION NOT AVAILABLE 

*K RESERVED WORD USED 


ERRORS: 
COMMAND ERRORS: 


*k*k UNABLE TO OPEN FILE 

**k*k TLLEGAL OPERATION 

*k* TLLEGAL COMMAND 

**k*X TLLEGAL QUALITY 

**k* TLLEGAL INPUT COLUMNS 

**kkX BATCH COMMAND REQUIRED BUT NOT FOUND - FATAL ERROR 
**k*k TOO MANY LABELS (>250) 

**k*k TOO MANY INSTRUCTIONS (>1800) 

kkk LABEL SPACE OVERFLOW 


SOURCE ERRORS: 


*x*X SYNTAX UNACCEPTABLE, NO TRANSLATION MADE 
**k*K UNDEFINED OPCODE OR MACRO ENCOUNTERED 
*** UNTRANSLATABLE OPCODE ENCOUNTERED 


2-25. SAMPLE CALLS 


The following two examples demonstrate typical call sequences for 
TRANZ-.- In the first example, the sequence is entered as a single line; 
in the second, all commands and translation qualities are specified in 
response to prompts. 


Example 1: The call sequence 


>XPAS TRANZ SAGA, ,°,B- 
specifies batch operation translation of source file SAGA of default 
type .ASM, 8080/8085 assembly language source, with an object file 
SAGA.ZSC (default object filename since the destination file parameter 
is omitted). Translation parameters can be entered on a single line of 
up to 80 characters; in this format, the parameters must be separated 
with delimiters. Translation parameters are order-dependent; there- 
fore, when a parameter is omitted, a comma must be inserted in the | 
appropriate position to indicate the omission. 


For this example, an assumed error occurs. The error message 


ARK UNTRANSLATABLE OPCODE ENCOUNTERED 
RIM ! ; erroneous source statement 


is displayed during translation, followed by the completion message 


TRANZ COMPLETE: SOURCE 12345 BYTES 714 LINES 
OBJECT 17438 BYTES 


NOTES: 83 
WARNINGS: 20 
ERRORS: ] 


defines the number of bytes in the source and object codes, the number 
of lines in the source code, and the type and number of messages 
generated for the object produced. 


Example 2: The call sequence 
>XPAS TRANZ 


8080, 8085 AND Z80 TO Z8000 TRANSLATOR 
TRANZ 1.0 15 MAR 79 


ENTER SOURCE (DEFAULT IS -ASM): PARABLE 

ENTER DESTINATION (DEFAULT FILE IS PARABLE.ZSC): <NEW LINE keystroke> 
ENTER SOURCE ASSEMBLY LANGUAGE (I,5,Z): Z 

ENTER OPERATION (1,B): I 

ACTION (T,C,R,D,X,M,L,H): MODE SETTING 

MODE (L,C,D,T,0,1,S,A): DONT CARE QUALITIES (C,Z,S,P,A,F,D,B,K): CSZ 
MODE (L,C,D,T,0,1,8,A): ACTION 


ACTION (T,C,R,D,X,M,L,H): TRANSLATE UNTIL (E,S,’WD’,#): SEVERITY 
(N,W,Z):Z 


specifies an interactive mode translation of source file PARABLE of 
default type -ASM, 8080/8085 assembly language source code, and default 
object filename of PARABLE.ZSC. In the example, the object filename is 
specified by responding to the command line with a delimiter (NEW LINE 
keystroke). When interactive mode is selected, TRANZ responds with an 
ACTION command line. The next selection is MODE, to switch to the 
mode-setting commands. The mode-setting command sets the CSZ qualities 
to DONT CARE. The comma following the entry is a command delimiter; 
when this character is encountered, TRANZ responds with another MODE 
prompt. The next entry commands a switch to ACTION. 


The Action command response is Translate until an error of Severity Z 
is encountered. (Error severity Z is defined as a source statement for 
which no translated object code is available, or a command error is 
encountered. ) 


**k*X UNTRANSLATABLE OPCODE ENCOUNTERED 
RIM ! ; erroneous source statement 


ERROR SEVERITY = Z 


SOURCE PC = 988 
OBJECT PC = 1234 
CURRENT SOURCE LINE = 602 


RIM ! ; erroneous source statement 


ACTION (T,C,R,D,X,M,L,H): DELETE UNTIL (E,°WD’,#): END OF FILE 


TRANZ COMPLETE: SOURCE 988 BYTES 602 LINES 
OBJECT 1234 BYTES 


NOTES: 83 
WARNINGS: 20 
ERRORS: 1 


When the Z severity error is encountered, TRANZ displays the erroneous 
source statement (in the example the 8085 instruction RIM, which is 
untranslatable since there is no equivalent AmZ8000 instruction) and 
prompts for another action command. In this case the response is D, or 
delete (skip) all source instructions from the current line to the end 
of the file, save all previously translated instructions as the object 
file, issue the completion message, and exit to the operating system. 


2-26. SAMPLE PROGRAM TRANSLATION 


The following pages contain a sample TRANZ translation operation, in 
which 8080 code is translated into the functionally identical AmZ8000 
instructions. The sample is annotated to indicate specific commands, 
actions and responses during the translate operation. 


ee 


ADXEAS PRAKZ 


SYSTaM 6 PASCAL RUNNIYS.. = Y—_ TRANSLATOR 
INVOCATION 
HESK. 685 AND Z4@ TO 22003 TRANSLATOR 
ThANZ 1.0 11/12/75 
ENTER SOURCE (DFFAULT TYPE IS .ASM):. RTDEL 
ENTER GBJECT (DEFAULT FILE IS RTDEL.2ZSC): RTDEL.OEJ 
ENTER SOURCE ESSEMFLY L&ENGUAGE (1,5,2):1 
ENTFR OPERATION (B,I): I 
ERROR SEVENITY S 
SOURCE PC = 
OBJECT PC = 


CURRENT SOUFCE LINE 


ACTION (T,C,R,L,X, 


M,L,C) 
MOTE (L,C,L,T,0,1, 


Sib): 


ChARe QUALITIES (C,Z,S,P,A,F,D,?,K): 


> MOD#® SETTING 
CZSPAFDEK 


TRANSLATION QUALITIES 


INTEL ASSEMBLY LANGUAGE 


QUALITY SETTING 
DISPLAY 


8@8@ SOURCE MaCHINE 

C C CAREY FLAG 

C Z ZERO FLAG 

C 5 SIGN FLAG 

C P PARITY FLAG 

C A AUXILIARY CARRY FLAG 

C F FLAG PIT ORDERING 

C D : FECIMAL ADJUST SUBTRACT 
C b BYTE ORDER IN MeMORY 

C K FYTE ORDER ON STACK: 


MODE (L,C,D,7.0,1,5,A): 
MODE (L,C,D,T,0 = 


TERMINAL DISPLAY (S 
i A): ACTION COMMAND 


»042,WeN,C): SOZWNC 


ACTION (T,C,R,V,XM,L,C): REPLACE UNTIL (E,°wD’,#): @ 
REPLACE WITH Creat INATED BY //): PROGRAM Plie 
MAIN: 
// | 
PROGRAM MAIN} 
MAINS 
ACTION 


ERROR SEVERITY 
SOURCE PC 

OBJECT PC 

CURRENT SOURCE LIN 


roy ot 


ACTION (T,C,R,D,X,M,L,Q): 


READW TQU 10F 


ZREAD WITH WAIT 
CONST READW=17H; 
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<>} }+COMMAND 


= 1 
TRANSLATE UNTIL (£.S,°#D°,#): END OF FILE 
PREP JTTH WAIT 


SOURCE 
PS CODE 


WAIT EQU 47F ;DELAY FUNCTION 


Y%DELAY FUNCTION 
CONST WAIT#=40H; TRANSLATED 


SENTSW EQU = MESS ge oe 


CONST SENTSW=" MESS; 
REQCHN EQU 99 ;REQUEST CHANNEL 


ZREQUEST CRANNEL 
CONST RECCHN=99;3 


SYSTEM EQU 4 »SYSTEM CALL ENTRY POINT 


YSYSTEM CALL ENTRY POINT 
CONST SYSTEM=4; 


ORG USERA 


Spee teas pao ee WARNING 
“* EXPRESSION NOT EVALUATED 
wor OhG USFRKA 
ORIGIN USERA? 
Lk! ST,SSTACK 
L) R15,SSTACK} 
FETLUP LX] H,*rS5+3 
FETLUP:LD R3, MESS#33 
LXI D,€535 
LD R2,.65535; 
MVI C,RFOCHN +3¢K 
LDB RL1,REQCHN+8°H}3 
MVI A. READY <> _— SOURCE 
LDB RLG,READW; ele 
CALL SYSEKEC XECUTS CONSOLE KEAT 
“EXECUTE CONSOLE READ 


LD R5,SYSREQ; 
EXP RB5,KLS5; 


PUSH R15", h5} . <= _ TRANSLATED 
JP SYSREG} CODE 
LHLD  MESS+2 


* ADDRESS EXFRESSION COFRECTEL 
423 LHLD MESS +2 


| me MESSAGE 
LD R3,(°MESSCADDRESS PELATIV2 FIY>)73 
EXR RH3,RL3} 
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LDB KLO,RHS; 
ORA 


ORB RIC, RL35 
RESFLG CY; 

LDCTLE RL4,FLAGS; 
RESB RL4,353 

RESE RL4,23 
LICTILR FLAGS, RL45 


CALL TO FLAG-BIT 
GETNAA PUSH  PS# - ORDERING ROUTINE 
GETNAA:CALL @@G@3F2; 

EXE RHO,RLG} 

FUSH h15 ,R7; 


EXP PFO,RLO; 


~ BYPASS ROUTINES 


JR Q@@@@F1Z3 
QQ@QvF1i: &% FOF PSW 
~< CAKE AEOUT FLAG RIT ORDTR 
~ SURROUTINE TO PESTCRe FLAGS FROM 3@82 STYLE FSY TO 23000 
° CLEAK FLAGS 
CLEEB RL43 
¥ SeT TA AND H FLAGS 
RITE RHO,45 _ 
JR ZR,(°$+4)°3 
SETB KL4,<23 
LDCTLB FLAGS ,RL43 
Y RESTORE C 
BITB RHO,9} 
% SKIP NEXT INSTRUCTION FOR RESET 
JR ZR,(° $+4) 3 
SETFLG CY; 
Y RESTORE F 
BITB RHO@,23 
JR 2R,(°$+4) 73 
SETFLG PY} 
Y RESTORE S 
BITB RHZ,73 _ 
JR 2R,(°$+4) 3 
SETFLG SGN} 
% RESTORE Z 
BITR FHO,E3 
RET} 
@@@@F2: ZY PUSH PSw 
% CARE ABOUT FLAG BIT ORDER 
% SUBROUTINE TO CONVERT 237930 FLAGS TO #082 IN EH 
% GET FLAGS RYTE 
LDCTLB RL4,FLAGS;3 
Y CLEAR FLAGS 
CLRB RHQ; 
% P FLAG BIT 
JR PO,(° $+4)73 
SETB RHO,23 
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H ‘ : Aq 


% S FLAG BIT 
JR FL,( $+4)73 
SETP RH2,7} 
aC FLAG BIT 
JH NC,( $+4)73 
SETR RHC,O; 
Z 2 FLAG EIT 
JR NZ,(~$+4)7% 


SETB RHC, 6} 
Y SET DEFAULTS 

SETB RHO,1} 
% TEST AND SET A FLAG BIT 
BITB RL4,23 

JR 2ZR,(7$44)73 

SETB RHQ,4; 

LDCTLB FLAGS,R1L43 

RET} 

Q@@@C@F12! % DONE 


MOV A,P 
LDP RLG,RAI; 

CPI 4 
LDB RL4,RL@; 
SUPR RL4,4;5 
ANDB RL4,RL4;3 

JM POPTW#O 
JP MI,POPTWO; 


GETNAH POP PSW 
GETNAH:POP RO,R15°$ CALL TO FLAG-BIT 
EXB RHO, RLO; << ORDERING ROUTINE 
CALL @@@GQ@F13 

DCR R 


TECB RH1,1;3 
TESTB RH15 


STAX D 
LIP R2°,RLG} 
INX D 


LICTLE RL4,FLEGS3 

INC R2,13 

LICTLR FLAGS,PL43 

RYT: (14)3 

SRCE WS 11 ;SAVsS SOURCE FILE NAVE 
SnoetnohVaS SCUnoe FILF MAME 


LY¥te (11); 
DISKNO DS 1 sVskFAULT DISK 


PISKNOsZTERAULT DISn 
BYT= (1)5 


2-23 


TISFKKM LS 1 


DISFEM:%UNIT FROM GeTNAt 
PYTE (41)3 


Ls 2b 
STACK 
PYTE (2¢)$3 
ENT 
END. 


TRANZ COMPLETE: SOURCE 
OFJLCT 


ER&OnS: 
WARNINGS: 2 
NOT? S: ~~ 7d 


+UNTT FROM GETNAM 


»STACK 


COMPLETION 
MESSAGE 


-51 BYTES 264 LINES 
1<91 BYTES 


APPENDIX A 
( ASCII CHARACTER SET 


@ 
a ; a ! : He A st . a 
02 | 2 STX 22 Bee ie 42 | 66 |B 62 | 98 |b 
03 | 3 ETX 23 | 35 | # 43 | 67 |C 63 | 99 le 
04 | 4 EOT 24 | 36 | $ 44 | 68 | D 64 | 100/4d 
05 | 5 ENQ 25> i BR | 45 | 69 | E 65 101 |e 
06 | 6 ACK 26 | 38 | & 46 | 70 | F 66 | 102/f 
07 | 7 BEL 27 | 39 ‘ 47 | 71 |G 67 | 103} ¢ 
08 | 8 BS 28 | 40 | ¢ 48 | 72 |H 68 | 104 {h 
09 | 9 HT 29 | 41 ) 49 | 73 | I 69 | 105] i 
OA | 10 | LF 2A | 42 | * 4A | 74 | J 6A | 106 | j 
OB | ll | VT 2B | 43 | + 4B | 75 |K 6B 107 | k 
OC | 12 | FF 20. hth ig 4¢ | 76 | L 6C 108 | 1 
OD | 13 | CR 20 | 45 | - 4D | 77 | M 6D | 109 |m 
OE | 14 | SO 2E | 46 ; 4E | 78 | N 6E | 110]/n 
OF | 15 | SI 2F | 47 | / 4F | 79 | 0 6F | lll lo 
10 | 16 | DLE 30 | 48 | 0 50 | 80 |P 70 | 112) p 
11 | 17 | Del 31 | 49 | 1 51 | 81 | Q 71 113 /q 
12 | 18 | DC2 32 | 50 | 2 52 | 82 |R 72 | 1114/4 
13 | 19 | DC3 33 | 51 | 3 53 | 83 |S 73 | 115] s 
14 | 20 | DC4 34 |52 |4 54 |} 84 |T 74 | 116) t 
15 | 21 | NAK 35 Bt Ye '5 55 | 85 | U 75 117 | u 
16 | 22 | SYN 36 | 54 | 6 56 | 86 |V 76 118 | v 
17 | 23 | ETB a7 i So 4 57 | 87 |W 77 119 | w 
18 | 24 | CAN 38 | 56 | 8 58 | 88 |X 78 | 120|x 
19 | 25 | EM 39 | 57 | 9 59 | 89 | Y 79 121 hy 
1A | 26 | SUB 3A | 58 : 5A | 90 |Z 7A | 122 | 2 
1B | 27 | ESC 3B | 59 : 5B | 91 [ 7B 123 | ¢ 
lc | 28 | FS 3c | 60 |< 5c | 92 | \ 7C 124 | | 
1D | 29 | GS 3D | 61 | = 5D | 93 | J 7D | 125 | } 
1E | 30 | RS 3E | 62 | > 5E | 94 | 7 7E | 126 | ~ 
1F | 31 | US 3F | 63 | ? 5F | 95 7F | 127 | DEL 


APPENDIX B 
FLAG-BIT ORDERING ROUTINES 


This appendix contains the flag-bit ordering routines, @@@@Fl and 
@@@@F2, that are added to the translated output code when the F trans- 
lation quality is set to care condition. With this care setting, the 
bits in the Flag Control Word (FCW) are exactly simulated in the output 
code- Note that the Care/Don’t Care status of the F quality must be 
identical for the PUSH/POP and CALL/RET instructions. 


TABLE B-1. FLAG FIX-UP ROUTINES — 


% BYPASS ROUTINES 
JR @@@@F12; 
@@@@F1: % POP PSW 
% CARE ABOUT FLAG BIT ORDER 
% SUBROUTINE TO RESTORE FLAGS FROM SOURCE PSW TO Z8000 
% CLEAR FLAGS 
CLRB RL4; 
% SET DA AND H FLAGS 
BITB RHG,4; 
JR ZR, (TS$+4)T; 
SETB RL4,2; Va 
LDCTLB FLAGS,RL4; 
% RESTORE C 
BITB RHG,O; 
% SKIP NEXT INSTRUCTION FOR RESET 
JR ZR, (TS$+4)T; 
SETFLG CY; 
% RESTORE P 
BITB RHG,2; 
JR ZR, (T$+4)T; 
SETFLG PY; 
% RESTORE S 
BITB RHQ,7; 
JR ZR, (T$+4)T; 
SETFLG SGN; 
% RESTORE Z 
BITB RHO,6; 
RET 5 a 


TABLE B-1. FLAG FIX-UP ROUTINES (Cont.) 


@@@@F2: % PUSH PSW 

% CARE ABOUT FLAG BIT ORDER 
%, SUBROUTINE TO CONVERT Z8000 FLAGS TO SOURCE FORMAT IN RHO 
% GET FLAGS BYTE 

LDCTLB RL4,FLAGS; 

7% CLEAR FLAGS 

CLRB RHQ; 

% P FLAG BIT 

JR PO, (T$+4)T; 

SETB RH4,2; 

4 S FLAG BIT 

JR PL, (T$+4)T; 

SETB RHQ,7; 

% C FLAG BIT 

JR NC, (T$+4)T; 

SETB RHO,9; 

% Z FLAG BIT 

JR NZ, (T$+4)T; 

SETB RH@,6; 

% SET DEFAULTS 

SETB RHG,1; 

% TEST AND SET H FLAG BIT 
BITB RL4,2; 

JR ZR, (T$+4)T; 

SETB RHQ,4; 

LDCTLB FLAGS, RL4; 
RET 5 
(¢ @@@@F12: % DONE 


ie er 


APPENDIX C 
PSEUDO-OPERATION EQUIVALENCIES 


Table C-l defines the directive equivalencies of the Am8080, Intel 
8080/8085, Z80 and AmZ8000 assemblers. Operators that can be used in 
forming expressions are defined with the precedence of evaluation 
listed parenthetically following each operator. The 8080, Intel 
8080/8085 and Z80 source statements are all MACRO8 (MAC) assembler 


compatible; the AmZ8000 statements are MACRO8000 (MACZ) assembler 
compatible. 


TABLE C-1. PSEUDO-OPERATION EQUIVALENCIES 


AMC INTEL 
8080 8080/85 Z80 AmZ8000 
PSEUDO-OPs 


ORIGIN ORG ORIGIN 
(or -PHASE<addr> 
eee - DEPHASE) 


EXTERNAL Label followed EXTERNAL EXTERNAL 
by "##" 
or EXTRN 
or EXT 


GLOBAL Label followed PUBLIC GLOBAL GLOBAL 
by Meg HE 
or PUBLIC 
or ENTRY 


VAR X: OBJECT; 
SET variable Has 


EQU constant CONST X=...; 
END END. 


allocate 
storage BYTE (n) 


count: string _ STRING: ’. 


string: EOS 


string of ra 
characters : 
“a 
- reverse - values and - all - reverse 
word store of DW characters DW reverse DEFW store WORD: 
bytes reversed values WORD : SWAP (X) 
only 
byte DB DEFB BYTE: 
absolute PC ASEG (default) (default) ABSOLUTE 
Data PC % SEGMENT 
DSEG PAGE , [@CUM] , “DSEG’; 
INPAGE 
Code PC CSEG(default) — ¥ SEGMENT 
CSEG PAGE [@CUM] , “CSEG’ 
INPAGE 
named or blank 
"common" SEGMENT [ @COM] 
segments 
Stack Length SEGMENT 
[@COM] , STACK’; 
BYTE (n)3 
SEGMENT @PRIOR; 
Comments See e<cr> ex pee e<Cr> fee eSCr> 
or «COMMENT Or 
<delim> (eae 
---<delim 00 eX) 
display "MOUNT 
TAPE" wait for 
myn entry 
_ 


TABLE C-1. PSEUDO-OPERATION EQUIVALENCIES (Cont.) 


PSEUDO-OPs 
set default 
radix 
OPERANDS 


BO Stack 


EO Program +l 


binary 
octal 
decimal 
hex 


specified radix 


representation 


Literals: 


Line # (source 
line header) 


Identifiers 
case 
Labels length 
lead 
char. 
ops labels 


pseudo-op 
labels 


legal charac- 
ters 


(Identifiers are 


non-reserved 
words) 


ignore 


addresses 
PC 


statement 
separator 


listing 
options 


RADIX r 
r is. 2.«s16 


MeeeB 
ne--O or Q 
NeeeD OF Nees 


ne-eeH or X°xxx’ 


8 or 16 bits 


<escape> or 
'escape 


Weeder or ere a 


Line # 
(high bit on) 


UC = le 
6 characters 


$]-1?]@la oe. 


trailing colon 


trailing colon 


AceeZd 
0...9 
$,-,7,@ 


expression 


$ 


<cer> 


~LIST 

-XLIST 

«LALL, ~-SALL, 
.XALL, «CREF, 
- XCREF 

SEJECT 

PAGE [size] 


STACK 


MEMORY 


MeeeB 
ne»-O or Q 
NeeeD OF Nees 


n-e.eH 


8 or 16 bits 


!escape 
"<< a An a 
UC = lc 


6 characters 


eee s @uwe, Geese 


trailing colon 


trailing blank 


expression 


$ 


<er> 


NeeeB 
ne--O or Q 
NeeeD OF Nees 


neee-H 


16 bits 


UC #lc 
6 characters 


trailing colon 
or character 
in column l 


trailing colon 
or character 
in column l 


AeeeZ 


0.2.9 
? 


_ (underscore) 


expression 


$ 

<cer> 

*List ON 
*List OFF 
*Maclist ON 
*kMaclist OFF 


*Eject 


(see "specified 
radix") 


EXTERNAL 
/STACK/ 


EATERNAL 
/HIGH ADDRESS/ 


n--B 

n---0O or Q 
NeeeD OF Neos 
neeeH or #n-.. 


rine. 
ris 2..16 


variable 


a an ae 
< 


Q="' 


Uc = IC 
unlimited 


Os ong - Becks 


trailing colon 


trailing colon 


AceeeZ 
0..-9 
@ 


_ (underscore) 
ignore 
embedded __in 


numbers 


expressionf 


LIST 
NOLIST 


EJECT 
PAGE n 


AMC INTEL 
8080 8080/85 Z80 AmZ8000 
La a SS a ae ee ee ee ee ee ee gs ee WN 


C-3 


PSEUDO-OPS 


Name 
Title 


include 


Terminal Output 


MACROS 


Parameters 


Macro Library: 


User Symbol 
Generation: 


evaluate 


concatenate 


counter 


Conditional 
Assembly 


if true 

if false 
else 

end 
Conditionals 
Pass l 
Pass 2 
defined 
blank 
expression 
F=0 


T#0 
(paren allowed) 


C-4 


TABLE C-1. 


NAME (%...°) 
[S]TITLE ’ 
SUBTTL ’.. 


- PRINTX<delim> 
«+ -<delim> 

MACRO 

standard symbol 

ENDM 

EXITM 

LOCAL 

REPT exp 

IRP = var,<vy-.+-> 

IRPC var,<.-.> 

or 


IRPC varee. 


«REQUEST 


& (before user 
symbol only) 


IF or IFT 
IFE or IFF 
ELSE 


ENDIF 


IF1l 
IF2 


IFDEF 
{not (IFNDEF) ] 


IFB 
[not (IFNB)] 


INTEL 
8080/85 


MACRO 

standard symbol 
ENDM 

EXIT 

LOCAL 

REPT 

IRP 


IRPC 


he 


&(before or after 
user symbol) 


*Heading 


*Include 


MACRO 
leading # 


ENDM 


#SYM 
Incrementing 
counter 


PSEUDO-OPERATION EQUIVALENCIES (Cont.) 


AmZ 8000 


MODULE ’...° 
TITLE: * 


INCLUDE 


MACRO 
standard symbol 


END ; 

EXIT; 

VAR x:object; 
FOR exp DO BEGIN 
FOR var IN (v]...-) 
DO BEGIN 

FOR var IN ’ 
DO BEGIN 


IF...-THEN BEGIN 
If NOT... 


END ELSE BEGIN 


END 


TABLE C-1. PSEUDO-OPERATION EQUIVALENCIES (Cont.) 


PSEUDO-OPs 


OPERATORS 
null 

High byte 
Low Byte 


* 


/ 

MOD 

shift right 
shift left 
— unary 

+ 

+ unary 
NE 

LE 

GE 

EQ 

GT 


LT 


OR 


XOR 


residue ~- after 
+overflow 


kk 

unsigned GT 
unsigned GE 
unsigned LT 


unsigned LE 


AMC INTEL 
8080 8080/85 Z80 AmZ8000 
ee ee 


NUL (1)* 
HIGH (2) 
Low (2) 

x (3) 

/(3) 

mop (3) 

sur (3) 

SHL (3) 

- unary (4) 
465) 

A) 

+ unary (5) 
nE (6) 

LE (6) 
GE(6) 

£9 (6) 

ct (6) 


LT (6) 


not (7) 
AND (8) 


or (9) 


xor(9) 


NUL ¢1)* 
HIGH (2) 
Low (2) 

x (3) 

/@Q) 

mop (3) 

SHR (3) 

sui (3) 

~ unary (4) 
(4) 

~(4) 

+ unary (4) 
nE(5) 
LEG) 
GE(5) 

£9 (5) 

eT (5) 

LT (5) 

not (7) 

AND (7) 


or (8) 


xor (8) 


x (3) 

/ (3) 

MoD. (3) 
SHR. (3) 
~SHL. (3) 

- unary (4) 
+(4) 


~(4) 


+ unary(1) 


B 
i) 
I 
. 
— 
. 
o 
WN 
w 


-RES. (1) 


#x (2) 


-uGT. (7) 


-ULT. (7) 


NULL (1)* 
HIGH (2) 
Low(2) 

* (3) 

7(3) 

mop (3) 

sur (3) 

sy (3) 

~ unary (4) 
405) 

'€5) 

+ unary (4) 
NE (6) 

LE (6) 
GE(6) 

EQ (6) 

GT (6) 

LT (6) 

not (7) 

AND (8) 


or (9) 


XOR(9) 


Let (6) 
LGE (6) 
LLT (6) 


LLE (6) 


NOTE 
*Parenthetical numbers indicate operator precedence in each language. 
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APPENDIX D 
8080/8085 CODE TRANSLATION SUMMARY 


Table D summarizes the object code generated by TRANZ for each 8080/ 
8085 source code line- TRANZ allows the user to specify, through a 
series of prompts, Care or Don’t Care conditions for the selected 
translation qualities. As shown the object code generated differs, 
depending on the setting of qualities. With some instructions, up to 
five lines of object code (14 bytes) can be generated to satisfy the 
Care-code settings specified by the user. 


The table also defines the FCB flag bits affected by the instruction; 
i.e., bits modified or set to a specific value to reflect the results 
of the operation. A or 1 entry in the flags-affected column 
indicates the constant value of the related bit following execution of 
the instruction; the flag code letter in the entry indicates that the 
flag is used to define the CPU condition following execution, and a 
blank indicates that the flag setting is unchanged. 


The FCB flag bits and translation qualities are defined as: 


C = Carry 
Z = Zero 
S = Sign 


P = Parity (same as Z80/AmZ8000 P/V, Parity/Overflow) 

A = Auxiliary Carry (AC, same as Z80/AmZ8000 H, Half Carry) 

B = Byte Swap (word/byte reference order reversal) 

K = Stack Byte Swap (word/byte stack reference order reversal) 
F = Flag Bit ordering 


D 


Decimal Adjust (same as Z80/Z8000 N flag) 


Within the instructions, the following abbreviations and symbols are 
used: 


br = byte register 

bv = byte value 

mbr = mapped byte register 
mwr = mapped word register 


wr = word register 


wv = word value 
(xX) = contents of X 
(X) = complement of contents of X 


((X)) = contents of contents of X. 
Contents of designated location in inner brackets are 
interpreted as address to a second location that contains 
the 8-bit operand. 


TX = address of X 

XT = item referenced by the address of X 
<= = receives 

<—> = is exchanged with 

ix = logical AND 

V = logical OR 

V = logical EXCLUSIVE OR 


Note: Unless otherwise specified in the table, translated instructions 
are modified for AmZ8000 compability- In some cases, the modified in- 
exact object code is flagged with a message to that effect. Where only 
the length of the code is changed, a change message is not issued. Un- 
less flagged, the resultant object code is functionally identical to 
the source code. 


€-d 


8080/8085 
INSTRUCTION 


ANA br 
(8085 only) 


ANA M 
(8080 only) 


BYTE 
LENGTH 


TABLE D-1. 8080/8085 TRANZ CODE TRANSLATION SUMMARY 


CARE 
QUAL. 
SET 


OPERATION 


A<—(A)+(bv)+(c) 


A<—(A)+(br)+(C) 


A<—(A)+((M) )+(C) 


A<—(A)+(br) 


A<—(A)+((M) 


A<—(A)+(bv) 


A<—(A)/\(br) 


A<—(A)/\(br) 


A<—(A)/\((M)) 


FLAGS 


AFFECTED 


TOTAL 
AmZ8000 DON’T CARE BYTE 
CODE GENERATED LENGTH 


LDB RL4,bv;3 
ADCB RL@,wbr; 


ADCB RLO,mbr; 


LDB RL4,R3T; 
ADDB RLO,R3T; 


ADDB RLO,mbr; 


ADDB RLO,R3T; 


ADDB RLO,bv;3 


ANDB RLO,mbr; 


ANDB RLO,mbr; 


ANDB RLO,R3T; 


P 


» a 


AmZ8000 CARE 
CODE GENERATED 


LDB RL4,bv; 
ADCB RLO,RL4; 
ANDB RLO,RLO; 


ADCB RLO,mbr; 
ANDB RLO,RLO; 


LDB RL4,R3f; 
ADCB RLO, RL4; 
ANDB RLO,RLO; 


ADDB RLO,mbr; 
ANDB RLO,RLO; 


ADDB RLO,R3T;3 
ANDB RLO,RLO; 


ADDB RLO,bv; 
ANDB RLO,RLO; 


ANDB RLO,mbr; 
RESFLG CY; 


ANDB RLO,mbr; 
LDCTLB RL4, FLAGS; 
RESB RL4,3; 

RESB RL4,2; 
LDCTLB FLAGS,RL4; 


ANDB RLO,mbr; 
RESFLG CY; 


ANDB RLO,mbr; 
LDCTLB RL4,FLAGS; 
RESB 3,RL4; 

SETB 2,RL4; 
LDCTLB FLAGS ,RL4; 


ANDB RLO,R3T; 
RESFLG CY; 


ANDB RLO,R3T; 
LDCTLB RL4, FLAGS; 
RESB 3,RL4; 

RESB 2,RL4; 
LDCTLB FLAGS ,RL4; 


7-d 


8080/8085 
INSTRUCTION 


ANA M 
(8085 only) 


ANI bv 
(8080 only) 


ANI bv 
(8085 only) 


CALL addr 


BYTE 
LENGTH 


TABLE D-1. 8080/8085 TRANZ CODE TRANSLATION SUMMARY (Cont.) 


OPERATION 


A<—(A)/\(M) 


A<—(A) /\ (bv) 


A<—(A)/\ (bv) 


SP<——SP-2 
(SP) <—PC 
PC<—addr 


IF condition 
THEN CALL 


FLAGS AFFECTED 


AmZ8000 DON’T CARE 


CODE GENERATED 


ANDB RLO,R3T; 


ANDB RLO,bv;3 


ANDB RLO,bv; 


CALL addr; 


JR NC, (TS$+6)T 
CALL addr; | 


JR CY, (TS+6)T; 
CALL addr; 


AmZ8000 CARE 
CODE GENERATED 


ANDB RLO,R3T; 
RESFLG CY; 


ANDB RLO,R3T; 
LDCTLB RL4, FLAGS; 
RESB 3,RL4; 
SETB 2,RL4; 
LDCTLB FLAGS,RL4; 


ANDB RLO,bv; 
RESFLG CY; 


ANDB RLO,bv; 
LDCTLB RL4,FLAGS; 
RESB RL4,3; 
RESB RL4,23 
LDCTLB FLAGS ,RL4; 


ANDB RLO,bv; 
RESFLG CY; 


ANDB RLO,bv; 
LDCTLB RL4, FLAGS; 
RESB RL4,3; 
SETB RL4,2; 
LDCTLB FLAGS,RL4; 


LD R5,wv; 
EXB RH5,RL5; 
PUSH. RL5T,R5; 
JP addr; 


JR NC,(T$+14)T; LD 


R5,addr; 
EXB RH5,RL5; 
PUSH R15T,R5; 
JP addr; 


JR CY, (T$+14)T; 
R5,addr; 

EXB RH5,RL5; 
PUSH RI15T,R5; 
JP addr; 


c-d 


8080/8085 BYTE 
INSTRUCTION LENGTH OPERATION 


CP addr 


IF condition 
THEN CALL 


CPO addr 


CZ addr 


IF condition 
THEN CALL 


FLAGS AFFECTED 


AmZ8000 DON’T CARE 
CODE GENERATED 


JR MI, (T$+6)T; 
CALL addr; 


JR PL, (T$+6)T; 
CALL addr; 


JR PO, (TS$+6)T; 
CALL addr; 


JR PE, (T$+6)T; 
CALL addr; 


JR NZ, (TS+6)T; 
CALL addr; 


JR Z,(TS$+6)T; 
CALL addr 


AmZ8000 CARE 
CODE GENERATED 


JR MI, (T$+14)T; 
LD R5,addr; 

EXB RH5,RLS5; 
PUSH RI5ST,R5; 
JP addr; 


JR PL, (T$+14)T; 
LD R5,addr; 

EXB RH5,RL5; 
PUSH RL5T,R5; 
JP addr; 


JR PO, (T$+14)T; 
LD R5,addr; 

EXB RH5,RL5; 
PUSH RL5T,R5; 
JP addr; 


JR PE, (T$+14)T; 
LD R5,addr; 

EXB RH5,RL5; 
PUSH RI5T,R5; 
JP addr; 


JR NZ, (TS$+14)T; 
LD R5,addr; 

EXB RH5,RL5; 
PUSH RI5T,R5; 
JP addr; 


JR Z,(T$+14)T; LD 
R5,addr; 

EXB RH5,RLS5; 

PUSH ‘RI5T,R5; 

JP addr; 


LDCTLB RL4, FLAGS ; 


COMB RLO; 
LDCTLB FLAGS,RL4; 


N/A 


TOTAL 
BYTE 
LENGTH 
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TABLE D-1. 8080/8085 TRANZ CODE TRANSLATION SUMMARY (Cont.) 


TOTAL TOTAL 
8080/8085 BYTE . AmZ8000 DON’T CARE BYTE AmZ8000 CARE BYTE 
INSTRUCTION LENGTH OPERATION FLAGS AFFECTED CODE GENERATED LENGTH CODE GENERATED LENGTH 


C,Z<—(A)-(br) CPB RLO,mbr; LDB RL4,RLO; 
SUBB RL4,mbr;3 
ANDB RL4,RL4; 


C,Z<—(A)-(M) C ZS PAC CPB RLO,R3f; LDB RL4,R3f; 
SUBB RL4,RLO; 
ANDB RL4,RL4; 


C,Z<—(A)-(bv) CPB RLO,bv; LDB RL4,bv; 
SUBB RL4, RLO; 
ANDB RL4,RL4G; 


A<—2BCD digits DAB RLO; 
ANDB RLO,RLO; 


LDCTLB, RL4, FLAGS; 
SETB RL4,3; 

LDCTLB FLAGS ,RL4; 
DAB RLO; 


M<—(M)+(wr) RESFLG C; 
LDCTLB wr, FLAGS; 
ADD R3, mvyr; 
JR NC(TS$+2)T; 
SETB 7,RL4; 
LDCTLB FLAGS ,br; 


br<—(br)-1l DECB mbr,13 DECB mbr,1l; 
TESTB mbr; 
LDCTLB RL4, FLAGS; 
SUBB mbr,1; 
RESFLG CY; 
LDCTLB RL5, FLAGS 
BITB RL4,7; 
JR ZR, (7$+4)7;3 
SETB RL5,73 
LDCTLB FLAGS ,RL5; 


DECB R3T,1; 
(M) <—((M) )-1 DECB R3T,1; TESTB R3T; 


L-d 


TOTAL | TOTAL 
8080/8085 BYTE AmZ8000 DON’T CARE BYTE ' AmZ8000 CARE BYTE 
INSTRUCTION LENGTH | OPERATION FLAGS AFFECTED CODE GENERATED LENGTH ' CODE GENERATED LENGTH 


DCR M LDCTLB RL4, FLAGS; 
(continued) SUBB R3T,1; 
RESFLG CY; 
LDCTLB RL5,FLAGS 
BITB RL4,7; 
JR ZR, (7$+4)*; 
SETB RL5,7; 
LDCTLB FLAGS,RL5; 16 
wr<—(wr)-l DEC mwr,1; LDCTLB RL4, FLAGS; 
DEC mwr,1l; 
LDCTLB RL4,FLAGS; 6 
Interrupt DI VI,NVI; N/A 
enable<—0 
Interrupt EI VI,NVI; N/A 
enable<—l 
halt HALT; N/A 
A<— (port (bv)) INB RLO,bv; * 
br< —(br)+l ZS P AC INCB mbr,1; INCB mbr,1; 
TESTB mbr;3 4 


LDCTLB RL4, FLAGS; 

ADDB mbr,1; 

RESFLG CY; 

LDCTLB RL5, FLAGS; 

BITB RL4,7; 

JR ZR, (7$+4)7; 

SETB RL5,7; 

LDCTLB FLAGS,RL5 16 


(M) <—(M)+1 ZS P AC INCB R37, 1; INCB R37, 1; 
TESTB R3T; 4 


*Translation is not exact for hardware. Program need not be modified. Warning is issued. 
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TABLE D-1. 8080/8085 TRANZ CODE TRANSLATION SUMMARY (Cont.) 


TOTAL TOTAL 
8080/8085 BYTE AmZ8000 DON’T CARE BYTE AmZ8000 CARE BYTE 
INSTRUCTION LENGTH OPERATION FLAGS AFFECTED CODE GENERATED LENGTH CODE GENERATED LENGTH 
INR M LDCTLB RL4,FLAGS; 

(continued) ADDB R3T,1; 


JC addr 


JNC addr 


JP addr 


JM addr 


JPE addr 


JPO addr 


JZ addr 


JNZ addr 


JMP addr 


LDA addr 


LDAX wr 


LHLD addr 


LXI wr,wv 


wr<—(wr)t+l 


IF condition 
THEN JMP 


If condition 
THEN JMP 


PC<—(addr) 
A<—( (addr) ) 
A<—( (wr) ) 


M<——( (addr) ) 


wr<—(wv) 


CY,addr; 
NC ,addr; 
PL,addr; 


MI,addr; 


PE ,addr; 
PO ,addr; 
Z,addr; 


NZ ,addr; 


JP addr; 


LDB RLO,addrf; 


LDB RLO,mwrT; 


LD mhl,addrf; 


LD mwr,wv; 


RESFLG CY; 

LDCTLB RL5,FLAGS; 

BITB RL4,7; 

JR ZR, (7$+4)7; 

SETB RL5,7; 

LDCTLB FLAGS,RL5; 16 
LDCTLB RL4,FLGR; 

INC mwr,1; 

LDCTLB FLAGS,RL4; 6 


N/A 


N/A 


N/A 
N/A 
N/A 


LD R3,addrf; 
EXB RH3,RL3; 6 


N/A 
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8080/8085 BYTE 
_ INSTRUCTION LENGTH OPERATION 


wr<—— (SP) 
SP<——S P+2 


POP PSW 


SP<——SP-2 
(SP) <—wr 


PUSH PSW 


A Pas 
cSBttAS a? 
Ag<—(C) 


An<—(Ant1) 
C<—(Ag) 
A7<—(C) 


FLAGS AFFECTED 


C ZS P AC 


AmZ8000 DON’T CARE 


CODE GENERATED 


POP mwr,RI5T 


POP RO,RILST; 


LDCTLB FLAGS,RHO; 


PUSH R15f,mwr; 


LDCTLB RHO,FLAGS; 


PUSH R15T,RO; 


RRCB RLO,1; 


AmZ8000 CARE 
CODE GENERATED 


POP mwr,RI5T 
EXB mwrl,mwrh 


POP RO,RLST; 
CALL @@@@F1; 


POP RO,RLST; 
EXB mwrl,mwrh; 


LDCTLB FLAGS ,RHO; 


EXB mwrl,mwrh; 
PUSH R157T,mwr; 
EXB mwrl,mwrh; 


CALL @@@G@F2; 
PUSH RI5T,RO; 


LDCTLB RHO,FLAGS ; 


EXB RHO,RLO; 
PUSH R15T,RO; 
EXB RHO,RLO; 


LDCTLB RL4, FLAGS; 


RLCB RLO,1; 
JR NC, (TS+6)T; 
SETB RL4,7; 
IR (T$+4)T; 
RESB RL4,7; 


LDCTLB FLAGS ,RL4; 


LDCTLB RL4,FLAGS; 


RRCB RLO,1; 

JR NC, (TS+6)T; 
SETB RL4,7; 

JR (TS+4)T; 

RESB RL4,7; 
LDCTLB FLAGS,RL4; 


JR NC, (TS$+8)T; 
POP R5,R15T; 
EXB RH5,RL53 
JP RST; 


TOTAL 
BYTE 
LENGTH 


TABLE D-1. 8080/8085 TRANZ CODE TRANSLATION SUMMARY (Cont.) 


TOTAL TOTAL 


BYTE AmZ8000 DON’T CARE BYTE 


OI-d 


8080/8085 
INSTRUCTION 


MOV brl,br2 

MOV M,br 
br,M 
br,bv 


M,bv 


*kTranslation is not exact for hardware. 


LENGTH 


OPERATION 
brl<—(br2) 
(M) <—(br) 
br<—((M) ) 
br<—(bv) 
(M) <—((bv)) 
no-operation 


A<—(A) V (br) 


A<—A V (M) 
fix AC flag after 
logical op. 


A<—(A) V ((bv)) 


port (bv)<—(A) 


PC<—(HL) 


FLAGS AFFECTED 


Program need not be modified. 


CODE GENERATED 


LDB mbrl,mbr2;3 
LDB R3T,mbr; 
LDB mbr,R3T; 
LDB mbr,bv;3 
LDB R3T,bv; 
NOP; 


ORB RLO,mbr; 


ORB RLO,R3T; 


ORB RLO,bv; 


OUTB bv,RLO; 
JP R3T; 


Warning is issued. 


AmZ8000 CARE BYTE 


CODE GENERATED 


N/A 
N/A 
N/A 


ORB RLO,mbr; 
RESFLG CY; 


ORB RLO,mbr; 
LDCTLB RL4,FLAGS; 
RESB 3,RL4; 

RESB 2,RL4; 
LDCTLB FLAGS ,RL4; 


ORB RLO,R31; 
RESFLAG CY; 


ORB RLO,R3T; 
LDCTLB RL4, FLAGS; 
RESB RL4,3; 

RESB RL4,2; 
LDCTLB FLAGS,RL4; 


ORB RLO,bv; 
RESFLG CY; 


ORB RLO.bv; 
LDCTLB RL4,FLAGS; 
RESB RL4,3; 
RESB RL4,2; 
LDCTLB FLAGS ,RL4; 


LENGTH 


T[I-d 


+) 


8080/8085 
INSTRUCTION 


OPERATION 


IF condition 
THEN RETURN 


IF condition 
THEN RETURN 


PC<—((SP)) 
PCH<—((SP)+1) 
SP<—(SP)+2 


FLAGS AFFECTED 


AmZ8000 DON’T CARE 


CODE GENERATED 


TOTAL 
BYTE 
LENGTH 


AmZ8000 CARE 
CODE GENERATED 


JR CY, (TS$+8)T; 
POP R5,RI57T; 
EXB RH5,RL5; 
JP RST; 


JR MI, (TS$+8)T; 
POP R5,RI15f; 
EXB RH5,RL5; 
JP RST; 


JR PL, (T$+8)T; 
POP R5,RI157; 
EXB RH5,RL5; 
JP RST; 


JR PO, (TS+8)T; 
POP R5, RIST; 
EXB RH5,RL5; 
JP RST; 


JR PE, (T$+8)T; 
POP R5,RI15T; 
EXB RH5,RL5; 
JP RST; 


JR NZ, (TS+8)T; 
POP R5,R15f; 
EXB R5,RL5; 

JP RST; 


JR Z,(T$+8)T; 
POP R5,R15T; 

EXB RH5,RL5; 

JP RST; 


POP R5,RI15T;3 
EXB RH5,RL5;3 
JP RST; 


TOTAL 
BYTE 
LENGTH 


cI-d 


8080/8085 
INSTRUCTION 


SHLD addr 


SPHL 


STA addr 


STAX wr 


STC 


BYTE 
LENGTH 


TABLE D-1. 


OPERATION 


A(nt1)<—(An) 
Ag<—(A7) 
C<—(A7) 


“Aye —(A(nt1)) 


An<—(Ag) 
C<—(Ag) 


O<n<7 

SP<——SP-2 
(SP) <—PC 
PC<—n+8 


A<—(A)-(br)-C 


A<—(A)-(M)-C 


A<—(A)-(bv)-C 


(addr) <—HL 


SP<—(HL) 


(addr) <—(A) 


(wr) <—(A) 


C<—1 


8080/8085 TRANZ CODE TRANSLATION SUMMARY (Cont.) 


FLAGS AFFECTED 


TOTAL 
AmZ8000 DON’T CARE BYTE 
CODE GENERATED LENGTH 


RLB RLO,1; 


RRB RLO,1; 


CALL (n*8)T; 


SBCB RLO,mbr; 


LDB RL4,R3T 
SBCB RLO,RL4; 


LDB RL4,bv; 
SBCR RLO,RL4; 


LD addrf,R3; 


LD R15,R33 
LDB addrt,RLO; 
LDB mwrf,RLO; 


SETFLG CY; 


TOTAL 
AmZ8000 CARE BYTE 
CODE GENERATED LENGTH 


LDCTLB RL4, FLAGS; 
RLB RLO,1; 

JR NC, (T$+6)T; 
SETB RL4,7; 

JR (T$+4)T; 

RESB RL4,7; 
LDCTLB FLAGS ,RL4; 


LDCTLB RL4,FLAGS; 
RRB RLO,1; 

JR NC, (TS+6)T3 
SETB RL4,7; 

JR (TS$+4)T; 

RESB RL4,7; 
LDCTLB FLAGS,RL4; 


N/A 


SBCB RLO,mbr; 
ANDB RLO,RLO; 


LDB RL4,R3T; 
SBCB RLO,RL4; 
ANDB RLO,RLO; 
LDB RL4,bv;3 
SBCB RLO,RL4; 
ANDB RLO,RLO; 
EXB RH3,m1; 
LD addrf,R3; 
EXB RH3,m1; 
N/A 

N/A 

N/A 


N/A 


8080/8085 BYTE 
INSTRUCTION LENGTH OPERATION 


A<—(A)+(br) 


A<—(A)+(M) 


A<—(A)-(bv) 


XCHG (HL) <—> (DE) 


XRA br A<—(A)¥(br) 


XRA br 
(continued ) 


(A) <—(A)¥(M) 


A<—(A)¥(bv) 


(HL) <—((SP) ) 


FLAGS AFFECTED 


AmZ8000 DON’T 
CODE GENERATED 
SUBB RLO,mbr; 
SUBB RLO,R3T; 


SUBB RLO,bv; 


EX R3,R2; 


XORB RLO,mbr; 


XORB RLO,R3T; 


XORB RLO,bv; 


EX R3,R15f; 


Note: 8085 Instructions RIM and SIM will not translate to AmZ8000 format since TRANZ 
instructions. The error message UNTRANSLATABLE OPCODE ENCOUNTERED is issued. 


€1-d 


TOTAL 


CARE BYTE 
LENGTH 


does not support interrupt 


TOTAL 
AmZ8000 CARE BYTE 
CODE GENERATED LENGTH 


SUBB RLO,mbr; 
ANDB RLO,RLO; 


SUBB RLO,R3t; 
ANDB RLO,RLO; 


SUBB RLO,bv; 
ANDB RLO,RLO; 


N/A 


XORB RLO,mbr; 
RESFLG CY; 


XORB RLO,mbr: 
LDCTLB RL4, FLAGS; 
RESB RL4,3; 

RESB RL4,2; 

LDCTLB FLAGS,RL4; 


XORB,RLO,R3T; 
RESFLG CY; 

XORB RLO,R37; 
LDCTLB RL4, FLAGS; 
RESB RL4,3; 

RESB RL4,2; 
LDCTLB FLAGS,RL4; 


XORB RLO,bv; 
RESFLG CY; 


XORB RLO,bv; 
LDCTLB RL4,FLAGS; 
RESB RL4,3; 

RESB RL4,2; 
LDCTLB FLAGS ,RL4; 


N/A 


APPENDIX E 
Z80 CODE TRANSLATION SUMMARY 


Table E summarizes the object code generated by TRANZ for each Z80 
source code line- TRANZ allows the user to specify, through a series 
of prompts, Care or Don’t Care conditions for the selected translation 
qualities. As shown the object code generated differs, depending on 
the setting of qualities. With some instructions, up to five lines of 
obiect code (14 bytes) can be generated to satisfy the Care-code 


ee eee —_— SO ee ae 
settings specified by the user. 


The table also defines the FCB flag bits affected by the instruction; 
i.-e., bits modified or set to a specific value to reflect the results 
of the operation. A or 1 entry in the flags-affected column 
indicates the constant value of the related bit following execution of 
the instruction; the flag code letter in the entry indicates that the 
flag is used to define the CPU condition following execution, and a 
blank indicates that the flag setting is unchanged. 


The FCB flag bits and translation qualities are defined as: 


C = Carry 

Z = Zero 

S = Sign 

P/V = Parity/Overflow (same as AmZ8000 P/OV, similiar to 8080 P) 

A/H = Auxiliary Carry (same as AmZ8000 H, Half Carry similiar to 
8080 AC) 

B =~ Byte Swap (word/byte reference order reversal) 

K = Stack Byte Swap (word/byte stack reference order reversal ) 

F = Flag Bit ordering 

D/N = Decimal Adjust (same as Z8000 DA flag) 


Within the instructions, the following abbreviations and symbols are 
used: 


br = byte register 
bv = byte value 
mbr = mapped byte register 


mwr = mapped word register 


wr = word register 

wv = word value 

ir = index register, e.g. Z80 IX or IY register. 

mir = mapped index register, i-e. Z8000 register (used to 


simulate the Z80 IX or IY register) R11 and R12 
(respectively). 


b = a bit number, O through 7. 
(X) = contents of X 
(X) = complement of contents of X 


contents of contents of X. 

Contents of designated location in inner’ brackets are 
interpreted as address to a second location that contains 
the 8-bit operand. 


“~ 
“~ 
PS 
ww 
wa 
Il 


TX = address of X 

XT = item referenced by the address of X 
<< = receives 

<—> = is exchanged with 

/\ = logical AND 

V = logical OR 

V¥ = logical EXCLUSIVE OR 


Note: Unless otherwise specified in the table, translated instructions 
are modified for AmZ8000 compability. In some cases, the modified in- 
exact object code is flagged with a message to that effect. Where only 
the length of the code is changed, a change message is not issued. Un- 
less flagged, the resultant object code is functionally identical to 
the source code. 


+ = indicates that the preceeding flag is not supported for the 
instruction translation e.g. no translation fix up is 
provided. 


€-d 


INSTRUCTION | LENGTH OPERATION 


A, (HL) A<—A+tsrc+CY 


A, (irtbv) 


HL,wr 

A, (HL) A<—A+sre 
A, (irtbv) 

A,br 

A,bv 


wr, wr 


(HL) A<—A/\srce 


(irtbv) 


br 


Z<—(src)b 


TABLE E-1. Z80 CODE TRANSLATION SUMMARY 


TOTAL 


AmZ8000 DON’T CARE BYTE 


FLAGS AFFECTED CODE GENERATED LENGTH 


LDB RL4,R3T: 
ADCB RLO,RL4; 


LDB RL4,mirfT (bv); 
ADCB RLO,RL4; 


ADCB RLO,mbr; 


LDB RL4,bv3 
ADCB RLO,RL4; 


ADC R3,mwr; 

ADDB RLO,R3T; 

ADDB RLO,mirf (bv); 
ADDB RLO,mbr; 

ADDB RLO,bv; 


ADD mwr,mwr; 


ANDB RLO,R3T; 


ANDB RLO,mirf (bv); 


ANDB RLO,mbr; 


ANDB RLO,bv; 


BITB R3T,b; 


TOTAL 
AmZ8000 CARE BYTE 


CODE GENERATED LENGTH 


LDCTLB RL4,FLAGS 
ADD mwr ,mwr ; 

JR NC, (7$+6)~; 
SETB RL4,7; 

JR (7$+4)7; 

RESB RL4,7; 
LDCTLB FLAGS,RL4; 


ANDB RLO,R3T; 
RESFLG C; 


ANDB RLO,mirf (bv) 
RESFLG C; 


ANDB RLO,mbr; 
RESFLG C; 


ANDB RLO,bv; 
RESFLG C; 


9-4 


Z80 INSTRUCTION | LENGTH 


a A LS CASAC AAS Se EN RSE A RR RS 
eS TS 


BIT b,(irt+bv) 
BIT b,br 


CALL cond,addr 


CALL addr 


CCF 

CP (HL) 

CP (ir+tbv) 
CP br 

CP bv 


CPD 


OPERATION 


if cond. 
then CALL addr 


SP<—SP-2 
(SP) <—PC 
PC<—addr 


A-(HL) 
HL<—HL-1 
BC<—BC-1 


DO: A- (HL) 
HL<—4HL-1l 
BC<—BC-1 

Until:A=(HL) or 
BC=0 


TABLE E-1. Z80 CODE TRANSLATION SUMMARY (Cont.) 


FLAGS AFFECTED 


AmZ8000 DON’T CARE 
CODE GENERATED 


BITB mirf (bv) ,b; 
BITB mbr,b; 


JR not(cond) ,(T$+6)f; 
CALL addr; 


CALL addr; 


COMFLG CY; 

CPB RLO,R3T; 

CPB RLO,mirf (bv); 
CPB RLO,mbr; 

CPB RLO,bv; 


CPDB RLO,R3T,R1,ZR; 


CPDRB RLO,R3T,R1,ZR; 


TOTAL 
BYTE 
LENGTH 


AmZ8000 CARE 
CODE GENERATED 


JR not(cond) , (7$+14)7; 
LD R5,addr;3 
EXB RH5,RL5; 
PUSH RI5T,R5; 
JP addr; 


LD R5,addr;3 
EXB RH5,RL5; 
PUSH RL5T,R5; 
JP addr; 


CPDB RLO,R3T,R1,ZR; 
LDCTLB RL4, FLAGS; 
CPB RLO,R3f(1); 

JR PL, (T$+6)T; 

SETB RL4,5; 

JR (T$+4)T; 

RESB RL4,5; 

LDCTLB FLAGS,RL4; 


CPDRB RLO,R3T,R1,ZR; 
LDCTLB RL4, FLAGS; 
CPB RLO,R3T(1); 

JR PL, (TS$+6)T; 

SETB RL4,5; 

JR (T$+4)T; 

RESB RL4,5; 

LDCTLB FLAGS,RL4; 


TOTAL 
BYTE 
LENGTH 


20 


20 


G-d 


Z80 INSTRUCTION | LENGTH 


DEC (HL) 


DEC (irtbv) 


OPERATION 


A-(HL) 
HL<—HL+1 
BC<—BC-1 


A-(HL) 

HL<—4HL+1 

BC<—BC-1 
Until:A=(HL) or 
BC=0 


A<—2BCD(A) 


dst<—dst-l 


FLAGS AFFECTED 


TOTAL 
AmZ8000 DON’T CARE BYTE 
CODE GENERATED LENGTH 


CPIB RLO,R3T,R1,ZR; 


CPIRB RLO,R37T,R1,2ZR; 


COMB RLO; 


DAB RLO; 


DECB Rf, 1; 


DECB mirf(bv),1; 


AmZ 8000 CARE 
CODE GENERATED 


CPIB RLO,R3T,R1,2ZR; 
LDCTLB RL4,FLAGS; 
CPB RLO,R3T(-1); 

JR PL, (TS+6)T; 

SETB RL4,5; 

JR (T$+4)T; 

RESB RL4,5; 

LDCTLB FLAGS,RL4; 


CPIRB RLO,R3fT,R1,ZR; 


LDCTLB RL4, FLAGS; 
CPB RLO,R3f(-1); 
JR PL, (T$+6)T; 
SETB RL4,5; 

JR (T$+4)T3 

RESB RL4,5; 
LDCTLB FLAGS ,RL4; 


LDCTLB RL4, FLAGS ; 
COMB RLO; 
LDCTLB FLAGS ,RL4; 


DAB RLO;, 
ANDB RLO,RLO; 


LDCTLB RL4, FLAGS; 
SUBB R3T,1; 
RESFLG CY; 

LDCTLB RL5, FLAGS; 
BITB RL4,73 

JR ZR, (T$+4)T; 
SETB RL5,7; 
LDCTLB FLAGS,RLS5; 


LDCTLB RL4,FLAGS; 
SUBB mirf (bv), 1; 
RESFLG CY; 

LDCTLB RL5,FLAGS; 
BITB RL4,7; 

JR ZR, (TS$+4)T; 
SETB RL5,7; 
LDCTLB FLAGS,RL5; 


TOTAL 
BYTE 
LENGTH 


20 


20 


18 


20 


9-H 


TABLE E-1. Z80 CODE TRANSLATION SUMMARY (Cont.) 


BYTE FLAGS AFFECTED 
Z80 INSTRUCTION | LENGTH | OPERATION 
1 


ZSV1H 


TOTAL 
BYTE 
LENGTH 


TOTAL 
BYTE 
LENGTH 


AmZ8000 DON’T CARE 
CODE GENERATED 


AmZ8000 CARE 
CODE GENERATED 


DECB mbr,1; LDCTLB RL4, FLAGS: 
SUBB mbr,1; 
RESFLG CY; 

LDCTLB RL5, FLAGS; 
BITB RL4,7; 

JR ZR, (T$+4)T; 
SETB RL5,7; 


LDCTLB FLAGS,RL5; 18 
DEC mwr,1; LDCTLB RL4,FLAGS; 
DEC mwr,1; 
LDCTLB FLAGS,RL4; 6 
DI disable interrupts DI VI,NVI; 
DJNZ addr B<— 8-1 DBJNZ RH1,addr; 
if B40 then JP addr 
EI enable interrupts EI VI,NVI; 
EX (SP),wr (SP) <—wr EX R15f,mwr; 
EX AF,AF’ AF<—>AF’ LDCTLB RHO,FLAGS; CALL @@@@F2; 
EX RO,R7; EX RO,R7f; 
LDCTLB FLAGS,RHO; CALL @@@@F1; 10 


BC<—>BC’ EX R1,R8; 
DE<—>DE’ EX R2,R9; 
HL<—>HL’ EX R3,R10; 


halt HALT; 


* 
INB RLO,bv; 


IM n Set interrupt mode 


IN A, (bv) A<—port bv 
LDB RL4,RL1; 
LDB RH4,0; 


INB mbr,R4; 


IN br,(C) br<—port (C) 


* Untranslatable instruction. An error message is issued. 
** Translation is not exact for hardware. Program need not be modified. A warning is issued. 


TOTAL TOTAL 
BYTE AmZ8000 DON’T CARE BYTE AmZ8000 CARE BYTE 
Z80 INSTRUCTION | LENGTH OPERATION FLAGS AFFECTED CODE GENERATED LENGTH CODE GENERATED LENGTH 


INC (HL) dst<—dst+l INCB R3T,1; LDCTLB RL4, FLAGS; 

ADDB R3f,1; 

RESFLG CY; 

LDCTLB RL5,FLAGS; 

BITB RL4,7; 

JR ZR, (T$+4) Ts 

SETB RL5,7; 

LDCTLB FLAGS,RL5; 18 


INC (irtbv) INCB mirf (bv) ,1;3 LDCTLB RL4,FLAGS; 

ADDB mirf (bv) ,1; 

RESFLG CY; 

LDCTLB RL5, FLAGS; 

BITB RL4,7; 

JR ZR, (T$+4)T; 

SETB RL5,7; 

LDCTLB FLAGS ,RL5; 20 


INCB mbr,1; LDCTLB RL4,FLAGS ; 

ADDB RLO 1; 

RESFLG CY; 

LDCTLB RL5, FLAGS; 

BITB RL4,7; 

JR ZR, (TS+4)T; 

SETB RL5,73 

LDCTLB FLAGS ,RL5; 18 


INC mwr,1; LDCTLB RL4, FLAGS; 
INC mwr,1; 
LDCTLB FLAGS,RL4; 6 


(HL) <—(C) LDB RL4,RH1; ak 
B<—B-1l LDB RH4,0; 
HL<—4HL~-1 LDB RH1,0; 

INDB R3f,R1,R4; 

LDB RH1,RL4; 

JR OV, (TS+6) T; 

RESFLG ZR; 

JR (TS+4)T5 

SETFLG ZR; 


S~a 


Z80 INSTRUCTION 


(wr) 
addr 


cond ,addr 


addr 


cond ,addr 


BYTE 
LENGTH 
2 


TABLE E-1. Z80 CODE TRANSLATION SUMMARY (Cont.) 


OPERATION FLAGS AFFECTED 
0: 


DO: (HL) <—(C) 
B<—B-1 
HL<—4L-1 


Until: B=0 


(HL) <—(C) 
B<—B-1 
HL<—4L+1 


DO: (HL)—(C) 
B<—B-1 
HL<—HL+1 

Until:B=0 


PC<—(wr) 
PC<—addr 


If: cond 
then: JP addr 


PC<—addr 


If: cond 
then: JR addr 


TOTAL 
AmZ8000 DON’T CARE BYTE 
CODE GENERATED LENGTH 


LDB RL4,RH1; 
LDB RH4,0; 

LDB RH1,0; 

INDRB R3T,R1,R4; 
LDB RH1,RL4; 

JR OV, (T$+6) T; 
RESFLG ZR; 

JR (T$+4)T; 
SETFLG ZR; 


LDB RL4,RH1; 
LDB RH4,0; 

LDB RH1,0; 

INIB R3T,R1,R4; 
LDB RH1,RL4; 
JR OV, (TS+6)T; 
RESFLG ZR; 

JR (T$+4)T; 
SETFLG ZR; 


LDB RL4,RH1; 

LDB RH4,0; 

LDB RH1,0; 

INIRB R3T,R1,R4; 
LDB RH1,RL4; 

JR OV, (TS$+6)T; 
RESFLG ZR; 

JR (T$+4)T; 
SETFLG ZR; 


JP wrfT; 
JP addr; 


JP cond,addr; 


JR addr; 


JR cond ,addr; 


AmZ8000 CARE 
CODE GENERATED 


TOTAL 
BYTE 
LENGTH 


6-d 


TABLE E-1. Z80 CODE TRANSLATION SUMMARY (Cont.) 


TOTAL CARE TOTAL 
BYTE AmZ8000 DON’T CARE BYTE QUAL. AmZ8000 CARE BYTE 
Z80 INSTRUCTION | LENGTH OPERATION FLAGS AFFECTED CODE GENERATED LENGTH SET CODE GENERATED LENGTH 
1 


(wr)<—br LDB mwrf,mbr; 


(wr) ,br 


(HL) ,bv (HL) <—bv LDB R3T,bv; 
(irtbv) ,br (irtbv)<—br LDB mirf (bv) ,br; 
(irtbv) ,bv (irt+tbv) <—bv LDB mirf (bv) ,bv; 
(wv),A (wv) <A LDB (wv) f,RLO; 
(wv) ,wr (wv) <—wr LD (wv) T,mwr; EXB RHmwr ,RLmwr ; 
LD (wv)f,mwr; 
EXB RHmwr ,RLmvr ; 8 
br, (wr) br<—(wr) LDB mbr,mwrT; 
br, (ir+bv) br<—(irtbv) LDB mbr,mirf (bv); 
br,br br<—tr LDB mbr,mbr; 
br,bv br<—bv LDB mbr,bv; 
A, (wv) A<—(wv) LDB RLO, (wv) 7; 
wr, (wv) wr<—(wv) LD mwr, (wv) T;3 LD mwr,(wv)T;3 
EXB RH mwr, RL mwr; 6 
wr<—wr LD mwr ,mvwr ; 
wr<— wv LD mwr,wv;3 
A<—interrupt * 
interrupt<—A * 
refresh<—A LDB RHO,O; xk 
LDCTL REFRESH,RO; 
(DE) <—(HL) v otot LDDB R2T,R3T,R1; LDDB R2T,R3T,R1; 6 
DE<—DE-1 COMFLG PY; 


HL<—HL-1 
BC<—BC-1 


*kUntranslatable instruction. An error message is issued. 


TABLE E-1. Z80 CODE TRANSLATION SUMMARY (Cont.) 


TOTAL TOTAL 
AmZ 8000 DON’T CARE BYTE AmZ 8000 CARE BYTE 


Z80 INSTRUCTION | LENGTH OPERATION FLAGS AFFECTED CODE GENERATED LENGTH CODE GENERATED LENGTH 


OT-d 


NEG 
NOP 


OR (HL) 


OR (irtbv) 


OR br 


(DE)<——-(HL) 

DE<—DE-1 

HL<—4L-1 

BC<—8C-1 
Until: BC=0 


(DE)<—(HL) 
DE<—DE+1 
HL<—4L+1 
BC<—BC+1 


DO: (DE) <— (HL) 
DE<—DE+l1 
HL<—4HL+1 
BC<—BC-1 

Until:BC=0 


A<—0-A 
No operation 


A<—A V src 


(C)<— (HL) 

B<—B3-1 

HL<—HL-1 
Until :B=0 


otot 


P otot 


otot 


ozs P otot 


1? 2? 1+? 


LDDRB R2T,R3T,R1; 


LDIB R2T,R37,R1; 


LDIRB R2f,R3f,R1; 


NEGB RLO; 
NOP; 


ORB RLO,R3T; 


ORB RLO,mirf (bv); 


ORB RLO,mbr; 


ORB RLO,bv; 


LDB RL4,RH1; 
LDB RH4,0; 

LDB RH1,0; 

OTDRB R1,R3f,R4: 
LDB RH1,RL4; 

JR OV, (TS$+6)T; 
RESFLG ZR; 

JR (TS+4)T; 
SETFLG ZR; 


LDDRB R2T,R3T,R1; 
COMFLG PY; 


LDIB R2T,R3T,R1; 
COMFLG PY; 


LDIRB R2fT,R3T,R1; 
COMFLG PY; 


ORB RLO,R37; 
RESFLG CY; 


ORB RLO,mirf (bv); 
RESFLG CY; 


ORB RLO,mbr; 
RESFLG CY; 


ORB RLO,bv; 
RESFLG CY; 


kk 


TI7-d 


Me, 
: ; 


TABLE E-1. Z80 CODE TRANSLATION SUMMARY (Cont.) 


TOTAL CARE 
BYTE AmZ8000 DON’T CARE BYTE QUAL. | AmZ8000 CARE 
Z80 INSTRUCTION | LENGTH | OPERATION FLAGS AFFECTED CODE GENERATED LENGTH | SET CODE GENERATED 
(C)<—(HL) LDB RL4,RH1; ak 
B<—B-1 LDB RH4,0; 
HL<—HL+1 LDB RH1,0; 
Until:B=0 OTIRB R1,R3T,R4; 
LDB RH1,RL4; 
JR OV, (TS+6)T; 
RESFLG ZR; 
JR (T$+4)T; 
SETFLG ZR; 


OUT (c),br port (C)<—»br LDB RL4,RL1; ak 
LDB RH4,0; 
OUTB mbr,R4; 


port bv<—A OUTB RLO,bv; wk 


(C) <— (HL) LDB RL4,RH1; kk 
B<—B-1 LDB RH4,0; 
HL<—4HL-1 LDB RH1,0; 

OUTD R1,R3T,R4; 

LDB RH1,RL4; 

JR OV,(TS$+6) TS 


RESFLG ZR; 


JR (TS$+4)T; 
SETFLG ZR; 


(C)<—(HL) LDB RL4,RH1; ala 
B<—B-1 LDB RH4,0; 
HL<—HL+1 LDB RH1,0; 

LDB RH1,RL4; 

JR OV, (T$+6) Ts 

RESFLG ZR; 

JR (T$+4) Ts 

SETFLG ZR; 


PSW<— (SP) CZSPNH POP RO,RI5T; K POP RO,R15T; 
SP<—SP+2 LDCTLB FLAGS,RHO; EXB RLO,RHO; 
LDCTLB FLAGS,RH1; 


F POP RO,RIST 
CALL @@@@F1; 
LDCTLB FLAGS,RHI; 


TOTAL 


BYTE 
LENGTH 


Clad 


RES b, (HL) 
RES b,(irtbv) 
RES b,br 


RET 


RL (irtbv) 


Z80 INSTRUCTION | LENGTH 


TABLE E-1. Z80 CODE TRANSLATION SUMMARY (Cont.) 


OPERATION 


wr<—(SP) 
SP<—SP+2 


SP<—SP-2 
(SP)<—PSW 


SP<—SP-2 
(SP)<—wr 
(HL) p<—0 
(irtbv)}<—0 
brp<—0 
PC<—(SP) 


SP<—SP+2 


if: cond 
then: RET 


Return from interrupt 


Return from NMI 


CY<—b7 cz s P otot 
b1-7<_bo0-6 
bo<—CY 


c zs P otot 


FLAGS AFFECTED 


TOTAL 
AmZ8000 DON’T CARE BYTE 
CODE GENERATED LENGTH 
POP mwr,RIL5T; 


LDCTLB RHO,FLAGS; 
PUSH RI5T,RO; 


PUSH R15f,mwr; 


RESB R3T,b; 
RESB mirf (bv); 
RESB mbr,b; 


RET 


RET cond; 


(see RET) 
(see RET) 


LDB RL4,R3T 
RLCB RL4,1; 
LDB R37,RL4; 


LDB RL4,mirf (bv); 
RLCB RL4,1; 
LDB mirT (bv) ,RL4; 


TOTAL 
AmZ 8000 CARE BYTE 
CODE GENERATED LENGTH 


POP mwr,RL5f; 
EX RHmvwr,RLmwr; 


LDCTLB RH1,FLAGS; 
EXB RHO,RLO; 

PUSH R15T,RO; 

EXB RHO,RLO; 


CALL @@@@F2; 
PUSH R15f,RO; 


EXB RHmwr ,RLmvwr ; 
PUSH R15f,mwr; 
EXB RHmwr,RLmvwr; 


POP R5,RL5T; 
EXB RH5,RLS: 
JP RST; 


JR NOT cond, (T$+8)T; 
POP R5,R15f; 

EXB RH5,RL5; 

JR RST; 


kkk 


kk* 


LDB RL4,R3T; 
RLCB RL4,1; 

LDB R3T,RL4; 
ANDB RL4,RL4; 


LDB RL4,mirf (bv); 
RLCB RL4,1; 

LDB mirf (bv) ,RL4; 
ANDB RL4,RL4; 


tied 


Z80 INSTRUCTION 


RLC (HL) 


RLC (irtbv) 


RR (HL) 


oto+ 


zS P otot 


z Ss P Otot 


otot 


Ag-3< (HL) 4-7 
(HL) 4-7<(HL) 9-3 
(HL) 9~3<—Ag-3 


b7<—CY ZS P otot 
bo-~6<—_ 61-7 
CY<—bg 


TOTAL 
AmZ8000 DON’T CARE BYTE 
CODE GENERATED LENGTH 


RLCB mbr,1l; 


RLCB RLO,1; 


RL4,R37T; 
RL4,1; 
R3T,RL4; 


RL4,mirf (bv); 
RL4,1; 
mirf (bv) ,RL4; 


mbr,1l; 


RLO,1; 


LDB RL4,R3T; 
RLDB RLO,RL4; 


LDB R3fT,RL4; 


LDB RL4,R3T;3 
RRCB RL4,1; 
LDB R3fT,RL4; 


AmZ 8000 CARE 
CODE GENERATED 


RLCB mbr,1; 
ANDB mbr,mbr, 


LDCTLB RL4, FLAGS ; 


RLCB RLO,1; 

JR NC,(TS$+6)T; 
SETB RL4,7; 

JR (T$+4)T; 

RESB RL4,7; 
LDCTLB FLAGS,RL4; 


LDB RL4,R3T;3 
RLB RL4,1; 

LDB R3T,RL4; 
ANDB RL4,RL4; 


LDB RL4,mirf (bv) 
RLB RL4,13 


LDB mirf(bv) ,RL4; 


ANDB RL4,RL4; 


RLB mbr,mbr; 
ANDB mbr,mbr; 


LDCTLB RL4,FLAGS; 


RLB RLO,1; 
JR NC, (TS$+6)T; 
SETB RL4,7; 
JR (T$+4)T; 
RESB RL4,7; 


LDCTLB FLAGS,RL4; 


LDB RL4,R3T; 
RLDB RLO,RL4; 
LDB R3T,RL4; 
ANDB RLO,RLO; 


LDB RL4,R3T; 
RRCB RL4,1; 

LDB R3T,RL4; 
ANDB RL4,RL4; 


TOTAL 


BYTE 
LENGTH 


14 


12 


VIn-d 


TABLE E-1. Z80 CODE TRANSLATION SUMMARY (Cont.) 


TOTAL TOTAL 
BYTE AmZ8000 DON’T CARE BYTE AmZ 8000 CARE BYTE 
Z80 INSTRUCTION | LENGTH OPERATION FLAGS AFFECTED CODE GENERATED LENGTH CODE GENERATED LENGTH 
4 


LDB RL4,mirf (bv); LDB RL4,mirf (bv); 
RRCB RL4,1; RRCB RL4,1; 

LDB mirT (bv) ,RL4; LDB mirf (bv) ,RL4; 
ANDB RL4,RL4; 


RR (irtbv) 


RRCB mbr,1; RRCB mbr,1; 


ANDB mbr,mbr, 


RRCB RLO,1; LDCTLB RL4, FLAGS; 
RRCB RLO,1; 

JR NC, (TS+6)T; 
SETB RL4,7; 


JR (T$+4)T3 


LDB RL4,R3T; 
RRB RL4,13 
LDB R3f,RL4; 
ANDB RL4,RL4; 


zs P Otot RL4,R3T; 
RRB RL4,1; 


R3T,RL4; 


RRC (HL) 


LDB RL4,mirf (bv); 
RRB RL4,1; 

LDB mirf (bv) ,RL4; 
ANDB RL4,RL4; 


zs P otot LDB RL4,mirf (bv); 
RRB RL4,1; 


nirf (bv) ,RL4; 


RRC (irtbv) 


RRB mbr,mbr; 
ANDB mbr,mbr; 


mbr,1; 


RLO, 1; LDCTLB RL4, FLAGS; 
RRB RLO,1; 

JR NC, (TS$+6)T; 
SETB RL4,7; 

JR (T$+4)T; 

RESB RL4,73 
LDCTLB FLAGS ,RL4; 


LDB RL4,R3T; 
RRDB RLO,RL4; 
LDB R3T,RL4; 
ANDB RLO,RLO; 


zs P otot LDB RL4,R3T; 
RRDB RLO,RL4; 


LDB R3f,RL4; 


(HL) 4~7<—AgQ-3 
(HL) 9~3<—— (HL) 4-7 
Ag-3<— (HL) 9-3 


CALL addr; LD R5,addr; 
EXB RHS5 RLS; 
PUSH R15f,R5; 


JP addr; 


CALL addr 


RST addr 


BYTE 
INSTRUCTION | LENGTH OPERATION FLAGS AFFECTED 


A, (HL) A<—A-srec-CY 


A, (irtbv) 


A,br 


A,bv 


HL,wr 
cY<—1 
b, (HL) (HL),<—1 
b,(irtbv) (irt+bv),<—l 
brp<—_l 


CY<—b7 


by~7<—b0-6 
bg<—0 


(irt+bv) 


(irtbv) 


GI-d 


TOTAL 


AmZ8000 DON’T CARE BYTE AmZ 8000 CARE 
CODE GENERATED LENGTH CODE GENERATED 


LDB RL4,R3f; 
SBCB RLO,RL4; 


LDB RL4,mirf (bv); 
SBCB RLO,RL4; 


SBCB RLO,mbr; 


LDB RL4,bv, 
SBCB RLO,RL4; 


SBC R3,mwr; 
SETFLG CY; 

SETB R3T,b; 

SETB mirf (bv) ,b; 
SETB mbr,b; 

LDB RL4,R31; 

SLAB RL4,1; 

LDB R3T,RL4, 

LDB RL4,mirf (bv); 
SLAB RL4,13 

LCB mirf (bv) ,RL4; 
SLAB mbr; 

LDB RL4,R3T;3 

SRAB RL4,13 

LDB R3T,RL4, 

LDB RL4,mirf (bv); 
SRAB RL4,1; 

LDB mirT (bv) ,RL4; 
SRAB mbr; 

LDB RL4,R3T; 


SRLB RL4,1; 
LDB R3f,RL4, 


TOTAL 


BYTE 
LENGTH 


91-d 


TABLE E-1. 280 CODE TRANSLATION SUMMARY (Cont.) 


TOTAL TOTAL 
AmZ 8000 DON’T CARE BYTE BYTE 
Z80 INSTRUCTION | LENGTH OPERATION AFFECTED CODE GENERATED LENGTH LENGTH 


SRL (irtbv) LDB RL4,mirT (bv); 
SRLB RL4,1; 
LDB mirf (bv) ,RL4; 


SRLB mbr3 


(HL) A<—A-src RLO,R31; 
(irtbv) RLO,mirf (bv); 
br RLO,mbr3 


bv | RLO,bv; 


(HL) RLO,R3T; XORB RLO,R3T7; 
RESFLG CY; 


(irt+bv) RLO,mirf (bv); XORB RLO,mirf (bv); 
RESFLG CY; 


br RLO,mbr; XORB RLO,mbr; 
RESFLG CY; 


RLO,bv; XORB RLO,bv; 
RESFLG CY; 
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